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INTRODUCTION 


1 


SCOPE 


SCOPE OPERATION 


This manual deals with machine language programming of the Control Datav^ 
3200, 3100, and 3300 computers and the use of the monitor system, SCOPE, which 
controls job processing. SCOPE supervises the operation of the comprehensive 
library of utility programs provided by Control Data, including FORTRAN, 
COBOL, ALGOL, PERT, SORT and COMPASS, the flexible machine language 
assembler. The user may add programs to the SCOPE library through PRELIB, 
a SCOPE library program. 

SCOPE loads and supervises the execution of user programs and provides map¬ 
ping and debugging facilities, which include a selective dump routine called at 
the source or object language levels. Recovery from program failure is also 
provided by SCOPE, 

This manual does not repeat the detailed information in the programming ref¬ 
erence manual; when feasible, however, it summarizes pertinent information 
concerning hardware. 

Description of problem oriented languages such as FORTRAN and COBOL will 
be found in separate manuals. The hardware assembler language, COMPASS, 
is described here. 


SCOPE provides supervisory control of program execution. SCOPE includes 
processors for the following: 

Stacked or single job processing 
Loading relocatable programs 
Input/output control 
Interrupt control 
Debugging aids 

Library preparation and editing 
Forming and executing overlay programs 
Calling and executing utility routines 


The operator loads SCOPE from the library and provides information about date, 
time and the input/output configuration for the immediate system. SCOPE will 
process signal decks of proper structure or several decks from different 
programmers. 
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JOBS 


RUNS 


The programmer may select a library program for operation or load and 
execute his own subprograms. The operator may call library programs for 
execution. 


The sets of tasks assigned to SCOPE by the programmer are called jobs. A 
job may be stacked or non-stacked as indicated by a parameter in the JOB 
statement. 

In a non-stacked job, SCOPE releases the system input/output, and when the 
job is complete, halts the computer. To process another job after a non- 
stacked job, SCOPE must be reloaded by the operator. 

Stacked jobs afford greater convenience to the programmer and the operator, 
but they impose limits on the input/output requirements, which non-stacked jobs 
do not. Stacked jobs are processed in the order they appear on the standard 
input unit, except as otherwise directed by the operator. Regardless of the 
successful completion of the job, SCOPE will normally retain control of the 
system, log off the completed job and process another job in the stack. 

Non-stacked and stacl:ed jobs may be mixed on the standard input unit. More 
efficient use of the system results if non-stacked jobs are segregated, however. 

A job is preceded by a JOB statement which follows a SEQUENCE statement. 
SCOPE control statements, object subprograms, input to library programs and 
input to object programs may appear after the job statement. The job termi¬ 
nates with the occurence of another SEQUENCE statement. 


A non-stacked job consists of only one run. A stacked job may consist of one 
or more runs. A run consists of the execution of a complete program under 
SCOPE control; there are two types of runs. 

A library run consists of the operation of a library program under SCOPE con¬ 
trol. The library run is chosen by a library name statement such as COMPASS, 
COBOL or FORTRAN. 

The requested library program is loaded and operated. If errors are encoun¬ 
tered during loading, the entire job is terminated. If errors occur during 
operation ol the library program, subsequent programmer runs in the same 
job may be inhibited. A programmer run occurs when relocatable binary sub¬ 
programs followed by a RUN statement are loaded during a job. A programmer 
run may be prevented by errors in loading subprograms or errors during pre¬ 
vious library runs in the job. A programmer run may be successful or not. If 
a programmer run is inhibited or unsuccessful, the remainder of the job is not 
processed. 
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ASSEMBLER 


PROGRAM STRUCTURE 


SUBPROGRAM 


COMPASS 


The COMPASS assembly program converts programs written in COMPASS 
source language into a form suitable for execution under the monitor system. 
Source programs may consist of punched cards or BCD card images. The 
output from the assembler includes an assembly listing and a relocatable 
binary object program for immediate execution or punching. 


Source programs may be divided into subprograms which are assembled inde¬ 
pendently. All symbols are local to the subprogram in which they appear, 
unless they are declared as external symbols. Locations which will be ref¬ 
erenced by other subprograms are declared as entry points. When an entry 
point is found which matches an external symbol, linkage is established. The 
library tape is searched for routines with the names of the unmatched symbols. 
If unmatched symbols remain, the job is terminated and an error message 
produced. 


Throughout the discussion of SCOPE and COMPASS, the term "subprogram” 
will be encountered; it refers to the smallest unit which can be handled by 
COMPASS or the SCOPE loader. 


COMPASS is the comprehensive assembly system for CONTROL DATA com¬ 
puters. Operating under the SCOPE monitor system, COMPASS facilitates the 
writing of machine language programs through mnemonic instructions and 
symbolic addresses. 

The COMPASS language includes the following features: 


Address arithmetic 


Constants, symbolic addresses, and arithmetic 
expressions may be used for addresses. 


Character addressing Symbols may be assigned to character locations 

and character designators may be suffixed to 
word addresses. 

Preloaded data Data areas may be specified and loaded with data 

in the source program. 


Common assignments Common areas may be designated to simplify 

communication between subprograms. 
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Data definitions 


Library routines 


Listing control 


Diagnostics 


Macro instructions 


Integer, floating point, and BCD constants may 
be designated in familiar notation. 

Routines may be summoned from LIB during 
loading using source language statements. 

The format of the assembly listing may be 
controlled. 

Diagnostics for source program errors are 
included with the output listing. 

Sequences of instructions defined in a program 
will be inserted by the assembler whenever the 
macro name appears in an operation field. 
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COMPASS PROGRAMMING 


2 


In COMPASS source language, the programmer writes machine language instruc¬ 
tions in mnemonic/symbolic form, specifies constants, exercises control over 
subprogram communication and controls the assembly process with a powerful 
set of pseudo instructions. 

The programmer is assumed to be coding subprograms for assembly which are 
to be linked at load time and executed as a single unit. Thus, problems are 
expected to be solved by several subprograms or a program . This distinction 
is made for convenient discussion. The size of subprograms and the magnitude 
of the problems solved by a subprogram is at the discretion of the programmer. 


SUBPROGRAM A subprogram consists of an IDENT pseudo instruction and subsequent lines of 

code until and including and END pseudo instruction. The internal logical organ¬ 
ization is at the discretion of the programmer so long as a few simple rules are 
followed. These rules are developed in the discussion of pseudo instructions. 

Programmers using SCOPE and preparing subprogram in COMPASS or other 
source language must consider what happens when a subprogram is assembled 
or compiled, loaded and run. 

When writing machine language programs, a programmer must not exceed the 
capabilities of the hardware. Similarly, restrictions are imposed by the 
manner in which SCOPE and COMPASS or a compiler process subprogram 
information. Subprograms compiled or assembled independently may be linked 
by the loader. Thus, it is impossible for COMPASS or a compiler to anticipate 
all of the requirements for loading and execution. The responsibility for the 
structure of the program when loaded and the responsibility for correct execu¬ 
tion must remain with the programmer. 


ASSEMBLY FOR 

STORAGE Subprograms are assembled for an object machine with a storage element div¬ 

ided by convention into three areas: 

Data area 
Subprogram area 
Common area 
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A fourth area is encountered only if octal corrections are entered for the object 
program. This area is called the program extension area. 


The first three areas within a single source subprogram are defined at assembly 
time. Three pseudo instructions, DATA, COMMON and PRO, allow the pro¬ 
grammer to use these areas freely. When more than one subprogram is loaded 
for execution at run time, the areas for storage of all subprograms must be 
considered. The data area is the same for all subprograms at run time and 
must be of sufficient length to contain all of the information assigned to it by 
all subprograms. The programmer must also organize the information to be 
stored in the data area by the loader so that it will not conflict with information 
destined for the shared data area from other subprograms. 

COMPASS object code contains relocatable addresses, which are modified by a 
relocation factor during loading, to obtain the actual address in the computer 
memory. 

When assembling subprograms, COMPASS assumes that the initial location in 
each of the three areas, data, common and subprogram has a relocatable 
address of zero. 

Locations are assigned sequentially from zero unless the pseudo instruction 
ORGR is encountered. ORGR instructs COMPASS to assign the value in the 
address field of ORGR as the relocatable address of the following instruction 
and assign storage sequentially from that relocatable address. 

Each area recognized by COMPASS has its own address counter and the counter 
affected by ORGR depends on which counter COMPASS is using at the moment. 
The descriptions of the pseudo instruction DATA, COMMON, PRG and ORGR 
elaborate on this point. 

The address counter used by COMPASS for a given area is the same throughout 
the subprogram. If set by ORGR, the particular counter remains set until a sub¬ 
sequent ORGR. All counters are initialized before assembling anew subprogram. 


COMPASS 

INSTRUCTION 

FORMAT Instructions in subprograms to be assembled by COMPASS are written on cod¬ 

ing forms. The information on the coding form will be punched into cards or 
prepared on other suitable media for input to COMPASS. There is a one-to-one 
correspondence bcjtween columns on the coding sheet and card columns. 

Each line on the coding sheet is normally punched into a single card. Each line 
of code is divided into four fields and all instructions are discussed in terms of 
what may be placed in these fields. 
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location 1-8 inclusive, 9 always blank. 


operation begins in column 10 and continues until the first 

blank column. 

address may begin after the column terminating the opera¬ 

tion field; it must begin before column 41. The 
address field terminates with the first blank, or 
column 73. 

comments or remarks are written between the end of the address field 

and column 73. 

identification or 73-80 treated as a comment by COMPASS. 

sequence number 
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LOCATION FIELD 


The type of instruction determines the legal content of the location field. For 
most instructions, the location field may contain a symbol or be blank. How¬ 
ever, the use of symbols in the location fields of pseudo instructions is res¬ 
tricted; see the section on pseudo instructions for specific rules. 

A location field s;pnbol is composed of one to eight characters placed anywhere 
in the field. The first character must be alphabetic; subsequent characters 
may be alphabetic, numeric or a period. Imbedded blanks are illegal. An 
illegal symbol is flagged as an L error on the assembly listing. 

The location field symbol may represent a 15-bit relocatable address, a 17-bit 
address, or a 15-- or 17-bit nonrelocatable value. If the symbol represents an 
address, it is defined under control of one of the three address counters except 
for the special case of equating. The symbols defined under control of an add¬ 
ress counter references the first word or character position occupied by the 
particular instruction. 

When an asterisk appears in column 1, columns 2 through 72 are treated as a 
comment. 


OPERATION FIELD The operation field may contain mnemonic machine instruction codes or pseudo 
instruction mnemionics, with specific, related modifiers, macro instruction 
names, or the octal values, 00-77. 

The field begins in column 10 and is terminated by the first blank. If column 
10 is blank, an operation code of 00 is assembled. An illegal operation field 
is flagged as an o. error on the assembly listing. Modifiers are separated 
from operation codes by commas. 

The following are examples of acceptable operation fields; 

BSS, C 

BSS 

LDA 

INPC, INT, B, H 

MACRO 

74 
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ADDRESS FIELD 


SYMBOLS 


CONSTANT 


The address field of machine or pseudo instructions may contain one or more 
subfields separated by commas. The address field begins with the first non¬ 
blank character following the operation field and is terminated by a blank column 
or before column 73. It must begin before column 41. Address fields or sub¬ 
fields may contain symbols, constants or expressions. 

The address field of a machine instruction has one or more subfields separated 
by commas. Machine instructions have implied subfields. A subfield may be 
assigned the value zero by giving only its trailing comma or, if it is the last 
subfield in the address field, by omitting both its content and the preceding 
comma. 


A symbol in the address field may occupy the entire field or subfield or may be 
only one element in the field or subfield. 

Any symbol used in an address field must be defined by appearance in the loca¬ 
tion field of an instruction in the subprogram, or be declared as external. A 
symbol in the address field is formed and expressed exactly like a location 
symbol. A symbol in the address field may be relocatable or non-relocatable. 

A non-relocatable s 5 mtibol is defined or equated to a value which may be a num¬ 
ber of either 15 or 17 bits. The value assigned to the non-relocatable sjmibol 
will not be modified during loading. 

A relocatable S 5 anbol represents either a 15- or 17-bit address. Relocatable 
addresses are values related to a memory area which will be incremented or 
decremented by the loader prior to storage of the instruction in which the 
address occurs. 

Relocatable symbols are local or external to a subprogram and are equated to a 
15-bit word address or a 17-bit character address. Relocatable symbols maybe: 

subprogram relocatable 
external symbols 
data relocatable 
common relocatable 


The address field may contain signed or unsigned decimal or octal integers. If 
the sign is not present, the integer is understood positive. Octal integers are 
suffixed by the character, B. 
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SPECIAL CHARACTERS 


LITERALS 


Two special entries, a single or a double asterisk, may be made in address 
field. 

* The special character, * , may be placed in the address field and used as any 
symbol. The * is interpreted as the momentary value of the COMPASS address 
counter in effect when the * is encountered. The * may result in either a 15-bit 
or 17-bit address. If the machine instruction consumes two words, * is the 
address of the first word. 

** The special character, ** , may be used as the only entry in a field or subfield. 
The ** yields a subfield containing a one in each bit position. Normally, the 
field represented by the double ** will be modified during execution of the pro¬ 
gram and the double asterisk provides a convenient way to ascertain the mod¬ 
ification transpired. 


If the address field or subfield of an instruction refers to an operand which may be 
a single or double precision value, the entry may be a literal expressed as: = mv. 

The equal sign denotes that the field contains a literal; m denotes the mode of 
the literal; v is the literal. Single precision literals are expressed as above, 
double precision literals are expressed = 2mv; the digit, 2, preceding mode 
denotes a double precision field (48 bit) is to be established. 

The mode of a literal may be decimal, octal or Hollerith. 

Decimal Literals: = Dv 

The value, v, of the literal is expressed in decimal. The decimal value is 
expressed in the same manner as described for address subfields in DEC and 
DECD pseudo instructions. 

Octal Literals: = Ov 

The value of the octal literal is written in the same manner as a subfield for an 
OCT pseudo instruction except that 16 octal digits may be stated to obtain a 
double precision constant. 

Hollerith Literals: = Hv 

The Hollerith literal is expressed as a string of either 4 or 8 characters. The 
column following a Hollerith literal must be blank or a comma. 

During assembly, a literal is converted to binary and assigned a relocatable 
address which is substituted for the literal in the object code. Literals are 
assigned to contiguous storage locations at the end of the subprogram. Literals 
of the same value and size are not duplicated in the object subprogram. Each 
time COMPASS encounters a literal, the value is compared against the value of 
all previously assembled literals and if an identical value exists, the address of 
the previously assigned literal is substituted in the object code. 
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ADDRESS EXPRESSION 


ADDRESS OF 

ASSEMBLED 

INFORMATION 


In an address field or subfield, symbols, the special character, * , and numeric 
constants may be combined with the operators, plus or minus, to form an 
address expression. The value of the expression is calculated by substituting 
the numeric value of the symbol and performing 15- or 17-bit arithmetic using 
the operators. External symbols, the double asterisk, and literals may not 
appear in an address expression. 

If relocatable s 3 rmbols are part of an address expression, the result of the 
evaluated expression must be relocatable within a swingle area. Subprogram, 
data or common relocatable symbols may be mixed: 

D -P +P -D +C -C non-relocatable value 

X j. ^ ^ X ^ 

D-C+C positive data relocatable value 

C-P-C negative subprogram relocatable value 

D, P and C are data, subprogram and common relocatable addresses, 
respectively. 


In an expression containing relocatable symbols, the algebraic sum of the 
relocation indicators must be either an area relocation increment, an area 
relocation decrement, or no relocation designator and, therefore, a non- 
relocatable value. 

The result of an address arithmetic expression depends on the number of bits 
assigned to the subfield in the object code. 


The hardware storage element consists of 24-bit words. Each word is divided 
into four 6-bit character positions. The entire word or any character in the 
word is addressable. Machine language instructions and pseudo instructions 
may require either a word or character address. The character address 
consists of 17 bits in positions 16-0 of the word in storage. The word address 
consists of 15 bits in positions 14-0. Word or character addresses may be 
expressed in the same manner using COMPASS symbolic addressing techniques. 

Only the most significant 15 bits of a character address are relocated during 
loading. 
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FIELD DEFINITIONS FOR COMPASS INSTRUCTIONS 


Bit 

Number Positions 
of in Computer 


Symbol 

Meaning 

Literal 

Expression 

Absolute 

Relocatable 

External 

Bits 

Word 

b 

Index designator 1 to 3 


yes 

yes 



2 

16-15 or 17 

i 

interval, 0 to 7 


yes 

yes 



3 

17-15 

c 

character count 


yes 

yes 



7 

17-23 

c 

or character 


yes 

yes 



6 

18-23 

ch 

channel designator 


yes 




2 


m 

first operand word address 

yes 

yes 

yes 

yes 

yes 

15 

14-0 

u 

second Opei'and address 

yes 

yes 

yes 

yes 

yes 

15 

14-0 

r 

first operand character 
address 

yes 

yes 

yes 

yes 

yes 

17 

16-0 

s 

second operand character 
address 

yes 

yes 

yes 

yes 

yes 

17 

16-0 

V 

register file address, 

0 to TTg 


yes 

yes 



6 

5-0 

X 

connect code or interrupt 
mask 


yes 

yes 



12 

11-0 

y 

15-bit operand or shift 
count 

yes 

yes 

yes 

yes 

yes 

15 

14-0 

z 

17-bit operand 

yes 

yes 

yes 

yes 

yes 

17 

16-0 



ADDRESS 

SUBFIELDS 


m and n 


y 


r and s 


z 


b 


The address field entries m and n for machine instructions may be represented 
by a symbol, external symbol, literal, constant, expression or the special 
characters, * and **. The m and n subfields are generally operand addresses 
and always occupy bit positions 14-0 in the assembled instruction. 

The y subfield may be represented by a symbol, external symbol, literal, con¬ 
stant, expression or the special characters, * and **. The y subfield repre¬ 
sents an operand which occupies bit positions 14-0 in the assembled instruction. 

Machine language instructions using a 17-bit character address contain r or s 
subfields which may be represented as a symbol, literal, constant, external 
symbol, expression, or the special characters, * and **. These subfields 
occupy bit positions 16-0 of the assembled instruction. 

A 17-bit operand, z, may be represented by a symbol, constant, literal, expres¬ 
sion or special characters, * and **. The z field occupies bits 16-0 of the 
assembled instructions. 

The b subfield may be represented by a digit 1, 2, 3, a symbol equated to 1, 2, 
or 3, an expression whose value is 1, 2, 3, or **. The b subfield designates 
an index register. A b subfield is interpreted as follows: 

If it is used with m and n subfields; mnemonic operation codes may be 1, 2, 
or 3, and occupies bit position 16-15 in the assembled instruction. If an octal 
operation code is used, b may be 0-7 occupying bits 17-15 in the assembled 
instruction. 

If it is used with r and s subfields, b depends on the particular instruction; it is 
restricted by the instruction to only one digit and represents bit 17 of the 
assembled word. 

The i subfield occurs in the MEQ and MTH instructions; it may be a symbol, 
constant or expression which results in a value from 1 to 8, or **. The i 
subfield occupies bit positions 17-15 in the assembled instruction. 

In the following example ABLE = lOOg, INTERVAL = 1. 


Coding: Results (in octal) 


MEQ 

ABLE,INTERVAL 

06 

1 

00100 

MEQ 

ABLE, INTERVALfl 

06 

2 

00100 

MEQ 

ABLE, 2 

06 

2 

00100 

MEQ 

ABLE, 8 

06 

0 

00100 

MEQ 

ABLE,** 

06 

7 

00100 
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The V subfield in a machine language instruction denotes a location in the reg¬ 
ister file. It may be any sumbol, constant or expression which results in a 
value 0 to 77g, or **, The v subfield occupies bit position 5-0 in assembled 
instructions. 

The connect code for input/output units or the comparison mask for interrupt 
instructions is represented by x. May contain a symbol, constant, or expres¬ 
sion which results in a value 0 ^ x g 2 12 _ i, or **. 

This subfield contains the channel designator for input/output instructions. May 
contain a symbol, constant or expression which results in a value 0 ^ ch g 3, 

In the following examples, ABLE is equated to the value OOllg elsewhere in the 
program. 


Coding: 

TMA ABLE 
TMA 77B 
TMA ** 

TMA ABLE+22B 


The c subfield specifies the length of a character field or represents a search 
character. 

MOVE: The c subfield may be a symbol or an expression which results in an 
absolute value from 1 to 128, or**. 

SHOE or SRCN: The c subfield may be any symbol, constant, or ** which 
represents the 6-bit character code of the character for which the search is 
made. 


Results (in octal) 


53 

0 

2 


11 

53 

0 

2 


77 

53 

0 

2 


77 

53 

0 

2 


33 




In the following examples, ABLE is equated to the value 100 elsewhere in the 

program; BAKER to 00200 . 

8 


Coding: 

MOVE ABLE,baker,BAKER+IOOB 


MOVE 128,BAKER,BAKER+128 


MOVE 27B,BAKER,BAKER+27B 


MOVE **,BAKER,BAKER+IOOB 


word 1 
2 
3 

word 1 
2 
3 

word 1 
2 
3 

word 1 
2 
3 


Results (in octal) 


72000300 


40000200 


72000400 


00000200 


72000227 


13400200 


72000300 


77400200 
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EVALUATION OF 

ADDRESS 

EXPRESSIONS 


In the following examples, A is defined elsewhere in the program as the octal 
value 21; ABLE and BAKER are defined as 00200 and 00100 . 

O o 


Coding: 

SRCE A,ABLE,baker 


SRCE 21B,ABLE,BAKER 


SRCE A+2IB,ABLE,BAKER 


Result , (in octal) 


71 

00100 

21 

00200 



3 


word 1 

71 

00100 

2 

21 j 

00200 

3 





word 1 

71 

00100 

2 

42 

00200 

3 



Address expressions are evaluated as a word address (15 bits) or a character 
address (17 bits). All address expressions are converted to binary numbers of 
modulus 2^^ -1 or 2^-'^-l, and stored in the proper subfield. No size check is 
made for 15 or 17-bit subfields by COMPASS. 

The location terms of all instructions except BCD, C, BSS, C and EQU, C are 
evaluated as word addresses. 


word address, 
15 bits_ 


character address 
17 bits 


subfield type m, n, y, 


r, s, z, 


i, X, V, ch, b 


c 
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NON- 

RELOCATABLE 

SYMBOLS 


Symbols defined as non-relocatable values are treated as integers. If the most 
significant bit of a non-relocatable value is one, the integer is assumed to be in 
complement form. If a 17-bit non-relocatable value is placed in an m, n or y 
subfield, it is reduced modulo 2^^ -1. 


INTERCHANGE 
OF WORD AND 
CHARACTER 
ADDRESSES 


A word address may be placed in a character address field or vice versa. If a 
symbol defined as a word address is placed in a subfield which consists of 17 
bits, the assigned binary value is shifted left two places. 


If a symbol defined as a character address is placed in a subfield which has 
only 15 bits, the 17 bit character address will be shifted right two places. If 
a one bit is lost by the shift, a T error occurs. 
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ASSEMBLY OF MACHINE 3 

LANGUAGE INSTRUCTIONS 


The Control Data instruction repertoire for data processing, scientific and 
logical programming contains optional sets of BCD, floating point and double 
precision instructions for the hardware. All of these, including the optional 
commands, may be coded in the COMPASS language using convenient mnemonic 
codes and comprehensive S 3 rmbolic programming techniques. The purpose of 
this discussion is to describe how machine language instructions are expressed 
in COMPASS, how COMPASS assembles them, and how they appear in the ob¬ 
ject program. 

Control Data provides a set of simulation routines for the optional instructions. 
For any optional set not included at an installation, simulator routines may be 
placed on the library tape and called as subroutines. COMPASS will output the 
required XNL cards. Therefore, a programmer may use the mnemonics in the 
source subprogram as if the hardware were present. 

The 24 bits of the instruction may be expressed as 4 fields: 

operation code field, bits 23-18 
designator field, bit 17 
index or interval field, bits 16-15 
address field, bits 14-0 

Over half of the instructions are in this format, consisting of a mnemonic oper¬ 
ation code; an indirect addressing indicator, or a condition or sign extension 
designator; an index register designator; and an address or operand. However, 
in order to obtain the power of the repertoire, it was necessary to introduce 
other formats. 

To obtain the convenience desirable for symbolic programming and to exploit 
features of the computer, a flexible set of mnemonic codes and symbols was 
adopted for COMPASS. 

There are eight formats for machine language instructions. Five of these for¬ 
mats require one computer word of 24 bits. Three are unique to the Block 
Class, and consist of two 24-bit computer words. In the machine reference 
manual, these are referred to as three-word instructions. When coding in 
COMPASS, the Block instructions are written as one line of code which will 
yield two 24-bit words in the object program. The programmer must produce 
the third word for the reject instruction on a separate line. 
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Instruction fields may be optional or mandatory. Limits exist on all fields in 
any instruction; an optional field may be expressed or not, as the programmer 
requires. The indirect addressing field, bit 17, and the b field, bits 16-15 
are optional. Mandatory fields must be present and contain only stated options. 
The conditional modifiers ior the AZJ instruction are an example of a mandatory 
field. 
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Instruction 

Modifiers 

EQ 

NE 

GE 

LT 

I 

S 

INT 

A 

B 

H 

N 

C 

NC 


equal 
not equal 

greater than or equal 
less than 

indirect addressing 

extend sign of operand to 24 bits 

interrupt on completion 

conversion 

backward read or write 
half assembly or disassembly (12-24) 
no assembly or disassembly 
assign character address 
no conversion 


OCTAL 

OPERATION 

CODE 

SYMBOLIC INSTRUCTION FORMAT 

MNEMONIC 

INDEXING 

00.0 

HLT 

m 

00.1 

SLl 

m 

00.2 

SL2 

m 

00.3 

SL3 

m 

00.4 

SL4 

m 

00.5 

SL5 

m 

00.6 

SL6 

m 

00.7 

RTJ 

m 

01.1-3 

UJP,I 

m, b 

02.0 

no operation 

(see 14,0) 

02.1-3 

IJI 

m, b 


02.4-7 

IJD 

m, b 

03.0 

AZJ,£Q 

m 

03.1 

AZJ.NE 

m 

03.2 

AZJ,GE 

m 

03.3 

AZJ.LT 

m 

03.4 

AQJ.EQ 

m 

03.5 

AQJ.NE 

m 

03.6 

AQJ.GE 

m 

03.7 

AQJ,LT 

m 

04.0 

ISE 

y 

04.1-3 

ISE 

y, b 

04.4 

ASE,S 

y 

04.5 

QSE,S 

y 

04.6 

ASE 

y 

04.7 

QSE 

y 


OPERATION PERFORMED 


Unconditional stop RNI m 
If key 1 is set, jump to m 

If key 2 is set, jump to m 

If key 3 is set, jump to m 

If key 4 is set, jump to m 

If key 5 is set, jump to m 

If key 6 is set, jump to m 

(p) — (m^^^ _ , RNI m + 1 

RNI m 

If (B*’) = 0, RNI p + 1 

If (B*^) ^ 0, (B*^) + 1-►■(B^), RNI m 

If (B*’) = 0, RNI p + 1 

If (B*’) ^ 0, (B*^) - 1-►•(B^) RNI m 

If (A) = 0, RNI m, otherwise RNI p + 1 

If (A) ^ 0, RNI m, otherwise RNI p + 1 

If (A) >0, RNI m, otherwise RNI p + 1 
If (A) < 0, RNI m, otherwise RNI p + 1 

If (A) = (Q), RNI m, otherwise RNI p + 1 

If (A) ^ (Q), RNI m, otherwise RNI p + 1 

If (A) (Q), RNI m, otherwise RNI p + 1 

If (A) < (Q), RNI m, otherwise RNI p + 1 

If y =0, RNI p + 2, otherwise RNI p + 1 

If y = (B^), RNI p + 2, otherwise RNI p + 1 

If y = (A), RNI p + 2, otherwise RNI p + 1 sign 
extended 

If y = (Q), RNI p + 2, otherwise RNI p + 1 sign 
extended 

If y = (A), RNI p + 2, otherwise RNI p + 1 
A = bits 14-0 

If y = (Q), RNI p + 2, otherwise RNI p + 1 
Q = bits 14-0 


INSTRUCTION 

TYPE 

Ib 

Ib 

Ib 

Ib 

Ib 

Ib 

Ib 

Ib 

la 

la 

la 

la 

Ib 

Ib 

Ib 

Ib 

Ib 

Ib 

Ib 

Ib 

la 

la 

Ib 

Ib 

Ib 

Ib 
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05.0 

ISG 

y 

If 0 i 

, RNI p + 2, otherwise RNI p + 1 

Ib 

05.1-3 

ISG 

y, b 

If (B^)^ 

, RNI p + 2, otherwise RNI p + 1 

Ib 

05.4-7 

ASG,S 

y 

If (A) ^ , RNI p + 2, otherwise RNI p + 1 
sign extended 

Ib 

05.5 

QSG.S 

y 

If (Q) ^ , RNI p + 2, otherwise RNI p + 1 
sign extended 

Ib 

05.6 

ASG 

y 

If (A) ^ 

, RNI p + 2, otherwise RNI p + 1 

Ib 

05.7 

QSG 

y 

If (Q) 

, RNI p + 2, otherwise RNI p + 1 

Ib 

06.0-7 

MEQ 

m, i 

(B') - i .» (B'); if (B') negative RNI p + 1 





if (B') positive, test (A) = (Q) A (M), if 
true, RNI p + 2, if false, repeat sequence 

Ib 

07.0-7 

MTH 

m, i 

(B^) - i- 

— 1 » (B^); if (B^) negative, RNI p + 1; 





if (B ) positive, test (A) ^ (Q) A (M), if 
true RNI p + 2; if false, repeat sequence 

Ib 

10.0 

SSH 

m 

Test sign of (m), shift (m) left closed one, 
if sign negative RNI p + 2; otherwise p + 1 

Ib 

10.1-3 

ISI 

y, b 

If (B^’) = 

i y, 0-»-(B^) and RNI p + 2; if 





(B*") ^ 

i y, (B*^ + 1-»-(B^), RNI p + 1 

la 

10.4-7 

ISO 

y, b 

If (B*^) = 

^ y, 0-► (B*’) RNI + 2; if (B*^) A y, 





(B^") - 

1-► (B^’) , RNI p + 1 

la 

11.0 

ECHA 

y 

y —►(A) 

bit 0-16 

II 

11.4 

ECHA,S 

y 

y -(A) 

sign extended 

II 

12.0-3 

SHA 

y. b 

Shift A 1 

left, magnitude of shift in k, 

la 

12.4-7 

SHQ 

yi b 

Shift Q j 

right, complement of magnitude of 
shift in k 

la 

13.0-3 

SHAQ 

y. b 

Shift AQ 

left, magnitude of shift in k 

right, complement of magnitude in k 

la 

13.4-7 

SCAQ 

y, b 

Scale AQ 


la 

14.0 

NOP 


No operation (COMPASS assembled NOP) 

la 

14.1-3 

ENI 

y, b 

,,, _b 

Clear B , 

enter y 

la 

14.4 

ENA,S 

y 

Clear A, 

enter y, sign extended 

Ib 

14.5 

ENQ,S 

y 

Clear Q, 

enter y, sign extended 

Ib 

14.6 

ENA 

y 

Clear A, 

enter y 

Ib 

14.7 

ENQ 

y 

Clear Q, 

enter y 

Ib 

15.0 

no operation 





15.1-3 

INI 

y, b 

Increase 

b 

and B 

index B^ by y, sign extended on y 

la 

15.4 

INA,S 

y 

Increase 

A by y, sign extended 

Ib 

15.5 

INQ,S 

y 

Increase 

Q by y, sign extended 

Ib 

15.6 

INA 

y 

Increase 

A by y 

Ib 

15.7 

INQ 

y 

Increase 

Q by y 

Ib 

16.0 

No operation 





16.1-3 

XOI 

y, b 

Enter selective complement of y and (B ) into 

B^’ 

la 

16.4 

XOA,S 

y 

Enter selective complement of y and A into. A, 
sign of y extended 

Ib 

16.5 

XOQ,S 

y 

Enter selective complement of y and Q into Q, 
sign of y extended 

Ib 

16.6 

XOA 

y 

37 V (A ) -' » A, no sign extended 

Ib 

16.7 

XOQ 

y 

y V (Q) .Q, no sign extended 

Ib 

17.0 

No operation 





17.1-3 

ANI 

yi b 

y A (B^) ■ 

—J^B*’ 

la 

17.4 

ANA,S 

y 

3 ^ A (A) —A, sign of y extended 

Ib 

17.5 

ANQ,S 

y 

y A (Q) > Q, sign of y extended 

Ib 
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17.6 

ANA 

y 


y A(A)— ■» A, no sign extended 


Ib 

17.7 

ANQ 

y 


y A(Q) ■ '> Q, no sign extended 


lb 

20 

LDA, I 

m , 

b 

(M)-*^(A) 



la 

21 

LDQ, I 

m, 

b 

(M)-►(Q) 



la 

22 

LACK 

r , 

1 

(R)-»-(A) 



11 

23 

LQCH 

r , 

2 

(R)-*-(A) 



II 

24 

LCA,I 

m. 

b 

(M)-»^(A) 



la 

25 

LDAQ, I 

m, 

b 

(M)-*^(A), (M + 1) -»-(Q) 


la 

26 

LCAQ, I 

m, 

b 

(M)-JP-CA), (M + 1) -►(Q) 


la 

27 

LDL.I 

m, 

b 

(M) A (Q)-►(A) 



la 

30 

ADA, I 

m, 

b 

(M) + (A)—►(A) 



la 

31 

SBA,I 

m, 

b 

(A) - (M)-►(A) 



la 

32 

ADAQ.I 

m, 

b 

(M, M + 1) + (A, Q) ->-(A, 

Q) 


la 

33 

SBAQ,I 

m, 

b 

(A, Q) - (M, M + 1)-*-(A, 

Q) 


la 

34 

RAD, I 

m, 

b 

(M) + (A)-^(M) 



la 

35 

SSA,I 

m, 

b 

Where M contains a one_ bit, 

set the 

corresponding 






bit in A to one 



la 

36 

SCA, I 

m,. 

b 

Where M contains a one bit, complement the corre- 






sponding bit of A 



la 

37 

LPA,I 

m, 

b 

(M) A (A)-^(A) 



la 

40 

STA,I 

m, 

b 

(A) (M) 



la 

41 

STQ,I 

m, 

b 

(Q)-^ (M) 



la 

42 

SACK 

r , 

2 

(A5_o)-*-(R) 



II 

43 

SQCH 

r , 

1 

(^5-0^ "" > 



II 

44 

SWA, I 

m, 

b 

<Ai4-0>---^^^4-0> 



la 

45 

STAQ,I 

m, 

b 

(A, Q)-7-*- (M, M + 1) 



la 

46 

SCHA.I 

m, 

b 

^^16-0^ ^ ^^16-0^ 



la 

47 

STI,I 

m, 

b 

(b‘’)-^(»*14-o) 



la 

50 

MUA,I 

m, 

b 

(M) * (A>->-{Q, A) 



la 

51 

DVA,I 

m, 

b 

(A) / CM)-►-(A), Rem->-(Q) 


la 

52 

CPR,! 

m, 

b 

(M) > (A) , RNI p + 1 1 

1 







(Q) > (M) , RNI p + 2 

(A) & (Q) are 
unchanged 

la 





(A) ^ (M) > (Q) , RNI p + 3 J 

1 



53.1-3 

TIA 

b 


0—^(A), 



III 

53.40-70 

TAI 

b 





III 

53.01 

TMQ 

V 


(v) -► (Q) 



IV 

53.41 

TQM 

V 


(Q) - ►Cv) 



IV 

53.02 

TMA 

V 


(v) -^(A) 



IV 

53.42 

TAM 

V 


(A) - ►Cv) . 



IV 

53.(0+b)3 

TMI 

V , 

b 




IV 

53.(4+b)3 

TIM 

V 1 

b 

(b") -4- 



IV 

53.04 

AQA 



(A) + (Q) -► (A) 



III 

53.(0+b)4 

AIA 

b 


(A) + (B^) - ► (A) 



III 

53.(4+b)4 

lAI 

b 


(A) + (B^)— ► (B) 



III 

All other 

combinations of 53.00- 

77 are undefined and will be rejected 

by the assembler. 


54 

LDI,,I 

m, 

b 




la 

55.0 


no 

operation 
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55.1 

ELQ 



(Ej^) — ►(Q) 

Ib 

55.2 

EUA 



(E ) - ►(A) 

V. 

Ib 

55.3 

EAQ 



(E^, Ej^) - ►-(A, Q) 


55.4 


no operation 



55.5 

QEL 



(Q> -► (E^) 

Ib 

55.6 

AEU 



(A> —► (E^) 

Ib 

55.7 

AQE 



(A, Q)—►(E^, E^) 

Ib 

56 

MUAQ , I 

m, b 


(AQ) * (M) and (M + 1) - ^ (AQE) 

la 

57 

DVAQ 

m, b 


(AQE) / (M) and (M + 1) — ►- (AQ) and remainder 
with sign extended in E. Divide fault, 
halts operation and program advances to 
next instruction. 

la 

60 

FAD, I 

m, b 


Floating point addition of(M and M + l)to 
(AQ) — ► (AQ) 

la 

61 

FSB, I 

m, b 


Floating point subtraction of (M and M + 1) 
from (AQ) » (AQ) 

la 

62 

FMU,I 

m, b 


Floating point multiplication of (AQ) and 
(M and M + 1) — (AQ) 

la 

63 

FDV,I 

m, b 


Floating point division of (AQ) by (M and 

M + 1) —» (AQ) , remainder with sign extended 
to E 

la 

64t 

LDE 

m, 1 


Load E with up to 12 numeric BCD characters from 
storage. Field length specified by contents 
of D register. Characters are read consec¬ 
utively from least significant character (at 
address M + (D) - 1 until the most significant 

character (at address M) is in E. (E) is 
shifted right as loading progresses. The 
sign is acquired along with the least signifi¬ 
cant character. 

II 

65t 

STE 

m, 2 


Store up to 13 numeric BCD characters from E. 

Least significant character stored at 

M + (D) - 1 continuing back to most significant 
character stored in M. 

II 

66 t 

ADE 

m, 3 


Up to twelve 4-blt characters (most significant 
character at address M) is added to (E). Sum 
appears in E. D register specifies field 
length. 

II 

67t 

SBE 

m, 3 


Up to twelve 4-blt characters (most significant 
character at address m) is subtracted from E. 
Difference appears in E. D register specifies 
field length. 

II 

70.0-3 

SFE 

y. b 


Shifts E in one character (4-bit) steps. Left 
shift : bit 23 = 0, magnitude of shift = lower 

4 bits of Y = y + (Bb). Right shift : 

bit 23 = 1, magnitude of shift = lower 4 bits 

of complement of Y = y + (B*^). 

la 

70.4 

EZJ.EQ 

m 


(E) = 0, Jump to m; (E) 0, RNI p. + 1 

la 

70.5 

EZJ.LT 

m 


(E) < 0, Jump to m; (E) ^ 0, RNI p + 1 

la 

70.6 

EOJ 

m 


Jump to m if E overflow, otherwise RNI p + 1 

Ib 

70.7 

SET 

y 


Set (D) with lower 4 bits of y 

Ib 

71.0tt 

SRCB,INT 

c, r, 

s 

Search for inequality of character c in a list 
beginning at location r until unequal charac¬ 
ter is found, or until character location s 
is reached. < c ^ 63. 

Vb 

71.lttt 

SRCN,INT 

c, r, 

s 

Same as 71.0. 

Vb 

72 

MOVE,INT 

c, r. 

s 

Move c characters from r to s 1 ^ c ^ 128 

Vc 

73. Ot 

INPC,A, 

INr,B,H 

ch, r, 

1 s 

6 or 12-bit character read from peripheral and 
stored in memory at given location. 

Va 


t 7-bit operation code, last digit is one in bit 17 
tt 7-bit operation code and bit 17 on j) + 1 = 0 
ttt 7-blt operation code and bit 17 on p + 1 = 1 
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73.lt 

INAC.A.INT 

ch 

A cleared 6-bit character from peripheral to 
lower 6 bits of A. 

Va 

74. Ot 

INPW,A,INT, 

B,N 

ch, m, n 

Word address is placed in lower bits 0-14 

15-16 zero, 12- or 24-bit words are read from 
peripheral and stored in memory. 

Va 

74. it 

INAW.A.INT 

ch 

A cleared 12- or 24-bit word read from peripheral 
(size depends on I/O channel) into lower 

12 bits or all of A. 

Va 

75. Ot 

OUTC,A,INT, 

B,H 

ch, r, s 

Storage words assembled into 6 or 12-bit charac¬ 
ters and sent to a peripheral device. 

Va 

75.lt 

(XTAC.A.INT 

ch 

Character from lower 6 bits of A is sent to 
peripheral device, (A) retained. 

Va 

76. Ot 

OUTW,A,INT, 

B,H 

ch, m, n 

Words read from storage to peripheral device. 

Va 

76.lt 

OTAW,A,INT 

ch 

Word from lower 12 bits or all of A (depending 
on I/O channel) sent to a peripheral device. 

V 

a 

77.0 

CON 

X, ch 

If channel c 
RNI p + 1 

busy, reject instruction. 

III 




If channel c not busy, 12-bit connect code sent 
on channel c with connect cable 

RNI p + 2 

III 

77.1 

SEL 

X, ch 

Channel c busy, reject read from p + 1. c not 
busy, 12-bit function code sent on channel c 
with fn enable, RNI p + 2 

III 

77.2 

COPY 

ch 

External status code from I/O channel 

c - > lower 12-bits of A, contents of inter¬ 
rupt mask register upper 12-bits of A. 

RNI p + 1 

III 

77.3 

INS 

X, ch 

Sense internal status if 1 bits occur on status 
lines in any of same positions as 1 bits in 
mask, RNI p + 1. If no comparison, RNI 

p + 2. 

III 

77.3 

CINS 

ch 

Interrupt mask and internal status to A. 

III 

77.4 

INTS 

X, ch 

Sense for interrupt condition; if 1 bits occur 
simultaneously in interrupt lines and in 

RNI p + 1; if not, RNI p + 2 

III 

77.50 

INTS 

X 

Interrupt faults defined by x are cleared. 

III 

77.51 

lOCL 

X 

Clears I/O channel or search/move control as de¬ 
fined by bits 00-07 and 11 of x. Bits 08-10 
are not used. 

III 

77.52 

ssm 

X 

Selectively sets Interrupt Mask Register^ for 
each 1-bit in x, corresponding bit in 
register set to 1. 

III 

77.53 

SCIM 

X 

Selectively clears Interrupt Mask Register; for 
each 1-bit in x, corresponding bit in 
register is set to 0. 

III 

77.54-56 


no operation 




77.57 

lAPR 


Interrupt associated processor 

III 

77.6 

PAUS 

X 

Sense busy lines — if 1 appears on a line cor¬ 
responding to 1 bits in X, do not advance p. 

If p inhibited for longer than 150 usee, read 
reject from p + 1. If no comparison, 

RNI p + 2. 

III 

77.70 

SLS 


Program stops if Selective Stop switch is on; 
upon restarting, RNI p + 1 

III 

77.71 

SFPF 


Set floating 

point fault indicator. 

III 

77.72 

SBCD 


BCD fault flip-flop set 1. 

III 

77.73 

DINT 


Interrupt control is disabled. 

III 

77.74 

EINT 


Interrupt control is enabled, allows one more 
instruction to be executed before interrupt. 

III 

77.75 

77.76 

CTI 

CTO 


Set Type In | 
Set Type Outj 

beginning character address must be 
preset in location 23 of register 
file and last character 
address + 1 must be preset in 
location 33 of the file. 

III 

77.77 

UCS 


Unconditioned stop. Upon restarting RNI p + 1 

III 
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COMPASS PSEUDO INSTRUCTIONS 4 


SUBPROGRAM 

CONTROL 


IDENT 


END 


COMPASS contains a set of pseudo instructions for controlling the assembly 
process, converting constants, and reserving and assigning storage. 


Three pseudo instructions define a subprogram and provide control information 
for COMPASS. Information expressed in these pseudo instructions prepares 
control information for subsequent processing of the object program, including 
linking of subprograms. 


<blank> IDENT m 

IDENT serves to control COMPASS and provide a subprogram name of 8 char¬ 
acters or less. The location field of IDENT should be blank. If a symbol is 
present, it will be ignored by COMPASS. 

The address field contains the subprogram name; it may include as many char¬ 
acters as will fit into the field, but only the first eight are used as the subpro¬ 
gram name. They appear in the IDC card of the relocatable object subprogram 
deck and are printed as the title on the output listing unless, or until, a TITLE 
listing control pseudo instruction intervenes. 

IDENT information is used by SCOPE as a reference when octal corrections or 
SNAP are included in a job. The subprogram name is not an entry point name 
and cannot be referenced in the source subprogram. 

Instructions following IDENT are assembled using the subprogram address 
coimter ;intil the pseudo instructions DATA or COMMON intervene. 

An O error flag is given if IDENT appears as other than the first instruction 
in the subprogram, and IDENT is ignored. If IDENT is not the first instruc¬ 
tion, the job is terminated. 


< blank> END m 

END terminates the subprogram and produces a TRA card in the relocatable 
object subprogram deck. The location field should be blank; if present, it will 
be ignored by COMPASS. 
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A symbol in the address field is output to the TRA card as the symbolic trans¬ 
fer address. If the symbol is defined within the subprogram, the relocatable 
address is recorded on the <a> field of the TRA card. H a program is to 
receive control at the address denoted by the transfer symbol, the transfer 
address must be defined as an entry point during loading. 

The final instruction in a COMPASS subprogram must be END. 


FINIS <blanl^> FINIS <blank> 

FINIS signals that all subprograms have been assembled; it is the final instruc¬ 
tion of a COMPASS input deck. The location and address fields are ignored by 
COMPASS. Normally FINIS immediately follows an END pseudo instruction. 

COMPASS will write an end-of-file on all output units and if the unit allows, 
backspace over the end-of-file. However, COMPASS will recognize FINIS at 
any point even though it is in error and proceed as if END had occurred. If 
END is missing the job is terminated when control is returned to SCOPE. 


PROGRAM 

STORAGE AREAS The programmer may establish two storage areas to be shared by several sub¬ 
programs. The common area may be shared by subprograms for information 
which is processed by the running program, or accumulated during the course of 
execution. Information may not be assembled in the common area. At the 
source language level the programmer may label, reserve or otherwise organ¬ 
ize the common area but nothing more. 

Information assembled for storage into the data area may consist of constants, 
message formats, masks and other information to be used by more than one sub¬ 
program. Both the common and data areas are shared by all subprograms dur¬ 
ing execution. The significant difference is that data can be prestored or loaded 
by the loader; common cannot. Three pseudo instructions indicate which of the 
two storage areas is referenced, or whether the program area is being defined, 

During assembly, COMPASS initially uses the subprogram address counter. 
When the pseudo instructions DATA or COMMON are encountered, COMPASS 
assembles subsequent information into the appropriate area until another 
area assignment occurs. The pseudo instruction, PRG, returns control to 
the subprogram address counter. 

If any instruction or pseudo instruction which results in binary output occurs 
while COMMON is in effect, an error indication is given and assembly continues 
as if PRG had occurred in the source subprogram. Any one of the three loca¬ 
tion counters may be set by the pseudo instruction ORGR. When COMPASS 
initiates use of a different area address counter, or the counter currently in 
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PRG 


DATA 


COMMON 


ORGR 


effect is reset by an ORGR, or is incremented by a BSS pseudo instruction, 
the current RIF card will be output. 


<blank> PRG <blank> 

The PRG pseudo instruction establishes the subprogram location counter 
during assembly. PRG specifies that all instructions which follow are to be 
assembled in a subprogram area; it restores the subprogram location counter 
for use by COMPASS. When IDENT is encountered, the subprogram counter 
is initialized and remains so until DATA or COMMON occurs. The location 
and address fields are ignored by COMPASS. 


<blank> DATA <blank > 

"fhe DATA pseudo instruction specifies that all information following is to be 
stored or identified as part of the data area; it indicates use of the data area 
location counter. The location and address fields of DATA should be blank, 
and s 5 mibols contained in these fields are ignored by COMPASS. 

Any instruction or pseudo instruction may follow DATA, provided that no 
reference is made to an external name and no location within the data area 
is declared an entry point to the subprogram. Once the DATA pseudo instruc¬ 
tion occurs in a subprogram, the data area location counter is used for assem¬ 
bly until PRG or COMMON occur, or until the end of the subprogram. 


<blank> COMMON <blank> 

COMMON organizes, labels and reserves space in the common area. The 
location and address fields of COMMON should be blank, if they are not, 
COMPASS ignores the field. 

Information may not be assembled for storage in the common area; therefore, 
the only instructions which may follow COMMON are BSS, EQU, EXT, ENTRY, 
BSS, C, ORGR, IFT, IFN, IFF, IFZ, the output listing control instructions 
and PRG, DATA or END. If any other instruction is encountered, an error 
is flagged and assembly continues as if PRG had been encountered. 


< blank > ORGR m 

The ORGR pseudo instruction controls the relocatable address for storage of 
instructions, constants, or the reservation of space in any of the three storage 
areas. The location field of ORGR is ignored by COMPASS and printed on the 
output listing. The address field may contain an expression which results 
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in a value for a relocatable address. Symbols must have been defined in the 
location field of a preceding instruction; and if relocatable, be assigned to the 
same area as the address coimter currently in effect. 


Example: 

IDENT SAM 


DATA 
BSS 2 
MACl OCT 63 


PRO 

ORGR MACl+16 


The above sequence would be incorrect because MACl + 16 would be in 
the DATA area and not under control of the subprogram address counter 
placed in effect by PRO. 


If COMPASS is assembling into one area and an ORGR occurs with a different 
area relocatable symbol in the address field, an error results. All address 
counters remain unchanged, and COMPASS ignores the ORGR. The error 
flag is included on the output listing. 


STORAGE 

reservation Full words or character positions may be reserved and labeled using the pseudo 
instruction BSS or BSS, C. The reservation is made in the area governed by 
the address counter COMPASS is currently using. The address field deter¬ 
mines how many words or character positions are to be reserved. 


BSS < blank or symbol> BSS m 

The BSS pseudo instruction reserves and labels a block of words in any area. 

The location field may be blank or contain a symbol which is defined as the 
15-bit relocatable word address of the first word in the block to be reserved 
by BSS, The assignment is made in the area governed by the address counter 
currently in effect for COMPASS assembly. 

The address field, which specifies the number of words to be reserved, must 
contain a constant, a s 3 nnbol, or an address expression which results in a non- 
relocatable value. 
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Example: 



The double asterisk (**) is illegal. The symbols in an address field must be 
defined in the location field of a preceding instruction. The result of an 
address expression must be a non-relocatable value. 


If the address field is in error or is zero, no storage is reserved but a 
symbol in the location field has been defined. If the address field contains 
zero, and the instruction is immediately preceded by BCD, C or BSS, C, the 
next instruction which consumes space will be forced to a new word. 

To illustrate: 

ALPHA BDC,C 3,ABC ALPHA 

BSS 0 

BDC,C 3,GHI ALPHA + 1 

ALPHA BDC,C 3,ABC ALPHA 

BDC,C 3,GHI ALPHA + 1 



BSS,C < symbol or blank> BSS, C m 

The pseudo instruction BSS, C reserves and labels a block of character positions 
in the area governed by the location counter currently in effect for a COMPASS 
assembly. 

The location field may contain a symbol or be blank. A symbol is defined as 
a 17-bit relocatable address of the first character in the block of characters 
to be reserved. The location symbol is defined as the momentary value of the 
current location counter. The address field specifies the number of characters 
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to be reserved. The address field must contain a constant, a symbol or an 
address expression which will result in a non-relocatable value. A zero 
address field does not reserve space, but the location symbol will be defined 
as above. When BSS, C is encountered, COMPASS will output the binary card 
it is building. 

ABLE BSS,C 25 


23_ 18 17_12 11_65_0 


ABLE 

ABLE+1 



i \ 

25 

characters 





















ABLE+24 

6 bits 








SUBPROGRAM 

COMMUNICATION 

AND LINKAGE Two pseudo instructions establish communication between subprograms. 

Programmers may define locations in a subprogram and declare them to be 
entry points. Symbols may be referenced within a subprogram even if they 
are not defined in that subprogram, provided they are declared as external 
symbols. Symbols declared external in one subprogram, will be declared as 
entry points in another subprogram. The resulting object subprograms will 
be loaded at the same time, but they need not be assembled at the same time. 

A location to be referenced by another subprogram is declared an entry point 
with the ENTRY pseudo instruction. If a reference is made to a location in 
another subprogram, the symbol defining that location must be declared an 
external symbol in an EXT pseudo instruction. Using ENTRY and EXT , 
COMPASS produces EPT and XNL loader cards. 

On the COMPASS assembly listing, instructions containing references to 
external names will have the usual format except the address field will be 
prefaced by X. These digits are the relocatable word address of a previous 
instruction in the subprogram area which references the external symbol. 

If it is the first or only reference to the external symbol, the address field 
listing will show X77777. 
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ENTRY 


EXT 


SYMBOL 
DEFINITION 
BY EQUATINO 


COMPASS places the subprogram relocatable address of the last instruction 
referencing the external s 3 anbol into the XNL loader card to begin the threaded 
list. If no reference is made to the external symbol in the subprogram, the 
XNL loader card will contain the address 77777 , indicating there is no thread. 

O 

Each external name can be associated with two threaded lists; one for 15-bit 
addresses and one for 17-bit addresses. All references are chained in the 
threaded list with only the symbol in the EXT declaration appearing in an 
XNL card. 


<blank> ENTRY m.,m„,. . .,m 

12 n 

The location field of ENTRY should be blank. If a symbol appears, it is 
ignored by COMPASS. The address field contains one or more location names 
separated by commas; it may not contain blanks. The field terminates with 
the first blank or column 73. 

Each subfield contains a sjonbol defined as a subprogram relocatable word 
address by appearance in a location field elsewhere in the subprogram. 


< blank > EXT m^,m„,. . .,m 
12 n 

Symbols referenced but not defined in the subprogram must be declared as 
external names in EXT pseudo instructions. 

The location field should be blank; a symbol is ignored by COMPASS. The 
address field contains one or more subfields up to column 73; subfields are 
separated by commas and may not contain blanks. This field terminates 
with column 73 or the first blank column. 

Each subfield contains a symbol which is output to an XNL loader card. The 
symbol must not be defined within the subprogram in which it is declared 
external; it may be referenced only from an instruction assembled into the 
subprogram area. 


A symbol may be defined by equating it to another symbol, a constant, or an 
expression. The symbol may be defined as an absolute value, a relocatable 
word or relocatable character address. The symbol in the location field of 
the pseudo instruction is equated to the value of the address field. A symbol 
which is declared an entry point in the subprogram must not be equated to a 
symbol declared as external. 
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I:QU 


EQU,C 


When the symbols are equated, they are identical and interchangeable; all 
symbols in the address field must have been previously defined by appearance 
in the location field of a preceding instruction or in an EXT declaration. 


< symbol> EQU m 

This symbol is equated to another symbol, a 15-bit word address or a 15-bit 
value. The symbol in the location field will be non-relocatable or relocatable 
as determined by the address field. If the location field does not contain a 
symbol, an error occurs. 

The address field det€:rmines the definition of the symbol in the location field. 
It may contain: 

15 

An integer niLodulo 2 -1. 

A symbol defined by appearance in the location field of a preceding 
instruction. The symbol in the location field is equated to the entry 
in the address field. If the symbol in the address field is relocatable 
into a given area, the symbol in the location field is also relocatable 
into that area. 

An address expression containing symbols defined as above, and 
conforming to tlie rules for m subfields. 

Expressions may not result in a complement relocatable value. 

An entry point should not be equated to an external symbol. COMPASS will 
not log an error but when the object subprogram is loaded an error will result. 


< symbol> EQU, C r 

The symbol is equated to a 17-bit address, 17-bit value or another symbol. 
The symbol in the location field will be nonrelocatable or relocatable as 
determined by the address field. If the location field does not contain a 
symbol, an error occurs. 

The address field determines the definition of the symbol in the location field. 
It may contain: 

17 

An integer modulo 2 -1. 

A symbol defined by appearance in the location field of a preceding 
instruction. The symbol in the location field is equated to the entry 
in the address field. If the symbol in the address field is relocatable 
into a given area, the symbol in the location field is also relocatable 
into that area. 
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COMPASS 
ASSEMBLY 
OF CONSTANTS 


OCT 


An address expression containing symbols defined as above and con¬ 
forming to the rules for r subfields. 

Expressions must not result in a complement relocatable value. 


Constants may be stated as octal, decimal or character in the source language. 
The constants may be single, double or variable precision of fixed or floating 
point format. Character constants may be placed into full words or character 
positions. Constants may be placed into bit positions of variable length fields. 

The pseudo instructions are: 

OCT prepare octal constants 

DEC prepare decimal constants, fixed point 

DECD prepare double precision and/or floating point 
decimal constants 

BCD prepare binary coded decimal (internal BCD) 

word fields 

BCD, C prepare binary coded decimal character position 

fields 

VFD prepare variable fields 


<symbol or blank> OCT m ,m , . . .,m 

X 4^ n 

Expresses constants as signed or unsigned octal integers. The octal integer 
may consist of eight or less digits. As many constants as can be contained on 
a card may be expressed in the address field; they are separated by commas. 
The octal constants are assembled, right adjusted, for storage into consecutive 
locations. The address field of OCT is terminated by the first blank or 
column 73. 

An optional binary scale factor may be stated by suffixing the constant by B 
and expressing the scale factor as a signed or unsigned decimal integer of not 
more than two digits. The magnitude of the constant after scaling must be 
less than 2 ^^. 

The location field may be blank or contain a symbol which yields the 15-bit 
word address of the first constant in the address field. 
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The address field contains as many subfields as the card will contain, 
separated by commas. The subfields are of identical form at, and each 
may contain a signed or unsigned octal integer of not more than eight octal 
digits., The address field is terminated by the first blank column. 

Exam]3le: 


OCT 77777777,12345670,76543210 
octal result 

word 1 

2 
3 


77777777 


12345670 


76543210 


OCT + 1, -57, 2040, -2 



DEC <symbol or blank> DEC d,,d„, . . . , d 

12 n 

Constants may be expressed in decimal and converted for storage as single 
precision fixed point binary constants. A decimal and/or binary scale factor 
may be expressed for the 24-bit constant. The decimal constant may consist 
of a sign and not more than seven digits with a magnitude of less than 2^^. 


The decimal integer may be followed by a decimal or a binary scaling factor 
or both. If both are stated, they may appear in either order. 

Examples: 



1 

decimal integer 


+2 

decimal integer 


-38 

decimal integer 


1D5 

decimal integer. 

decimal scale factor 

73D-2 

decimal integer, 

decimal scale factor 

-6D+1B4 

decimal integer. 

decimal and binary scale factors 

200B-7 

decimal integer. 

binary scale factor 

36B+2D1 

decimal integer. 

binary and decimal scale factors 
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DECD 


FLOATING POINT 
CONSTANTS 


23 

The magnitude of the constant after scaling must be less than 2 . The con¬ 

version is performed in three steps; 

1. The decimal integer is converted to binary; the binary 
integer must be less than or equal to 2r -1 in magnitude. 

2. The binary integer is multiplied or divided by 10^; d is 
the decimal scaling factor. The magnitude of the result 
must be less than 2'^'^. If the decimal scaling factor is 
negative, a 47-bit fraction or mixed fraction is formed. 

3. The result in step 2 is shifted the number of bits specified 
by the binary scaling factor. A negative factor produces 

a right shift; a positive scale factor causes a left shift to 
be performed. If non-zero bits are lost from the high 
order 24 bits of the result from step 2, an error is flagged. 

Low order bits of the intermediate result may legally be lost. 

The location field of the DEC instruction may be blank or contain a symbol 
which is the relocatable word address of the first constant in the address field. 

The address field may consist of as many subfields separated by commas, as 
the card can contain. The first blank terminates the address field and sub¬ 
sequent information is treated as remarks. 


< symbol or blank> DECD d , d , d.d 

1^0 n 

Decimal values may be stored as double precision fixed point constants or 
floating point constants. Either format requires 48 bits for storage. The 
format of the DECD pseudo instruction is the same as DEC except for the 
range of values and the point in floating point constants. The location and 
address fields are treated in the same fashion for DEC and DECD, A symbol 
in the location field references the first of the two words assembled as the 
result of DECD. 

Fixed point constant format is identical to that of the DEC single precision 
constants, except that magnitudes may be larger. Up to 14 decimal digits may 
be specified, expressing a value whose magnitude is less than 2^7. Decimal 
and binary scale factors may be used as in the DEC pseudo instruction. The 
signed 48-bit binary result is stored into two consecutive computer words. 


Floating point constants are stored as two 24-bit words. Floating point con¬ 
stants contain a decimal point. Floating point constants are stored as a 12-bit 
characteristic and 36-bit mantissa. Negative values are held in complement 
form. 
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23 


12 11 


0 


BCD 


BCD,C 


word 1 

characteristic 

man- 

word 2 

tissa 


Floating point constants may contain not more than 14 decimal digits and a 
decimal point which may appear anywhere within the constant. Binary scaling 
is not permitted. Dcjcirnal scaling is specified by suffixing the constant with 
a D followed by a signed or unsigned decimal scaling factor. In the absence 
of a sign, a positive value is assumed. The result after scaling must not 
exceed the capacity of the hardware (approximately 


<symbol or blank> BCD n,c^c„. . .c. 

1 2 4n 

Characters are assembled for storage into consecutive computer words. 

They are stored as (i-bit binary coded decimal character codes into address¬ 
able character positions. The code is the internal BCD code. 

The location field may be blank or contain a symbol which is established as 
the 15-bit relocatable word address of the first word in the field. The decimal 
integer, n in the address subfield contains the number of words to be used; n 
is separated from the characters to be converted and stored, by a comma. 

Four characters can be contained in a word, 4n characters may be punched in 
the card. If 4n characters cannot be held in the card before column 73, 
characters are converted through column 72. The character positions and/or 
words reserved by n, which cannot be expressed on the card, are filled with 
blanks. Any information on the card after 4n characters is treated as remarks. 


< symbol or blank> BCD, C n, c^c^. . . c^ 

Characters may be assembled for storage into consecutive character positions 
using the pseudo instruction BCD, C. The characters are converted and 
encoded as for BCD; but the address, the manner of storage, and the statement 
of field length differ. The location field may contain a symbol or be blank, 

A symbol, if present, is established as a 17-bit character address. 

The modifier, C, in the operation code denotes that character addresses and 
character string length are to be processed, not words. The card terminates 
after n characters or column 72, whichever occurs first. If n characters do 
not extend through column 72, information between the n characters and 
column 72 is treated as remarks; Character positions are filled 

from card columns imtil column 73. Character positions reserved but not 
expressed on the card £ire filled with blanks. 
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Characters are prepared for storage into consecutive positions. If the line of 
code immediately preceding BCD, C in the source program assigns character 
storage rather than word storage; the character string begins in the first 
available character position. If the line in the source program deals with 
word storage, BCD, C is assigned to the first character position in the first 
available word. The pseudo instructions which cause this variation are BSS, 

C and BCD, C. 

If the number of characters declared by BCD, C does not fill an entire word, 
the unused positions in the trailing partial word are filled with zeros. If the 
next instruction which consumes space in the object program is BCD, C, the 
positions in the partial word are assigned to the leading characters to produce 
a packed field. 

Example: 

MOTCC BCD 9,ABCDEFGHIJKLMN0PQRSTUVWXYZ=-+5.)-0$BCD4, *7,(1234567890 

The characters in the above line comprise the complete BCD character set; 
including the blank. 


Location 

MOTCC 


Content 


A 

B 

C 

D 

21 

22 

23 

24 

E 

F 

G 

H 

25 

26 

27 

30 

I 

J 

K 

L 

31 

41 

42 

43 

M 

N 

0 

P 

44 

45 

46 

47 

Q 

R 

S 

T 

50 

51 

62 

63 

U 

V 

W 

X 

64 

65 

66 

67 

Y 

Z 

= 

- 

70 

71 

13 

14 

+ 

+0 


) 

20 

32 

33 

34 

- 

-0 

$ 

* 

40 

52 

53 

54 

b 

/ 

f 

( 

60 

61 

73 

74 

1 

2 

3 

4 

01 

02 

03 

04 

5 

6 

7 

8 

05 

06 

07 

10 

9 

0 

6 

6 

11 

00 

60 

60 
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VARIABLE FIELD 
DEFINITION 


VFD MODES 


<symbol or blank> VFD mn/v,. . . ,mn/v 

This pseudo instruction enters octal numbers, character codes, relocatable 
addresses or constants into variable length field. The field is assigned as a 
continuous string of bits of specified length. Information is placed into the 
field regardless of word length or character position. Unused bits in the 
least significant bit positions of the final word in the field are filled with zeros. 

Each VFD instruction begins filling a new computer word. A symbol in the 
location field is defined as a relocatable word address. As many address 
subfields as can be contained on a single card are allowed; the address sub¬ 
field terminates with a comma except when a blank terminates the entire VFD 
pseudo instruction. The card and the VFD pseudo instruction are terminated 
by a blank. 

The mode parameter may designate one of four modes. The remainder of the 
subfield is restricted by the specified mode. Values are entered into variable 
fields right adjusted and character strings left adjusted. 

The location field may contain a legal symbol or blanks. A symbol, if present, 
yields a relocatable word address. The address field contains subfields of the 
same general format. 

m mode indicator 

n positive decimal integer denoting the number of bit positions 
in the variable field specified by this subfield. The range of 
values foi’ n varies with mode. 

/ the virgule separates the description of the field mode and 
length from the statement of the field content. 

V represents the content of the variable field which varies 
according to mode and is restricted by declared length. 

The address field may contain one or more subfields. The mode and length of 
the subfields may differ. 


The statement of variable field length and content varies according to the mode. 
Four modes maybe expressed in a VFD address subfield. 

O Octal 

II 6-bit Hollerith (internal BCD) 

A Word address arithmetic 

C Character address arithmetic 
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OCTAL 


HOLLERITH 


WORD ADDRESS 


VFD On/v 

If the mode is octal, O, n may be 1 to 24 and v may be a maximum of 8 octal 
digits; the integer may be signed. If negative, the filed content is stored in 
one’s complement form. The value is entered into the field right justified 
with leading bits inserted according to the sign and length. If the value exceeds 
the length of the field, an error is flagged and the field is set to zero. A 
binary scale factor may be supplied in the same manner as for an OCT pseudo 
instruction. 

A octal subfield is terminated by a comma or a blank. If terminated by a 
blank, the address field is terminated and remaining information on the card 
is treated as a comment. 


VFD Hn/v 

The programmer may enter Hollerith information which is stored as a 6-bit 
internal BCD character codes; n must be expressed as a multiple of six. The 
subfield, v, terminates with the first comma or blank. If the subfield does not 
terminate after n/6 character an error results. 


VFD An/v 

The word address field consists of a constant, a symbol, or an expression 
formed by the rules for address field arithmetic. The VFD address field is 
terminated by the first blank column. 

The location field may be blank, or contain a symbol. 

n is the field length, restricted by the contents. 

A type variable field length is 1 to 24. 

If an expression yields a relocatable word address, the 
value must be entered into the computer word right 
justified to bit zero by the programmer. The express¬ 
ion is evaluated modulo 2^^-l. 

If the expression of the subfield results in a fixed value 
the field specified by n will be evaluated 2^-1. 
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CHARACTER ADDRESS VFD Cn/v 

The character address variable field is governed by the above rules, except 
that a minimum of 17 bits is required. 

Example: 

VFDal2/-737, A21/A-X + B, H24/ + A3, A15/NAME+2, H12/BQ 

A, X, and B are not relocatable symbols. Four words are generated, 
with the data placed as follows: 


ALPHA 


ALPHA+1 


ALPHA+2 


ALPHA+3 


012/-737 A21/A-X+B 



cont'd NAME+2 



H12/BQ filler 
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MACRO USE IN COMPASS 


5 


ASSEMBLY OF 
MACROS AND 
MACRO CALLS 


MACRO 

INSTRUCTION 


A macro instruction is prepared with COMPASS pseudo instructions and macros 
are called by other pseudo instructions. 


MACRO 

ENDM 

IFT 

IFF 

LIBM 


define macro name and/or formal parameter 
terminate a macro prototype 

if a given condition is true, assemble instructions when 
the macro is called 

if a given condition is false, assemble instructions when 
the macro is called 

fetch the named macro prototypes from the library tape 
for use by the subprogram 


Macros are called by: 

<macro name> assemble the defined macro with this name, using the 
parameters given at this point in the subprogram. 


When an operation is performed frequently in a program or in many programs, 
the instructions required to perform that operation may be coded once and 
defined as a macro instruction. The macro is defined by pseudo instructions 
and called by an assigned name. The same code is obtained and included in the 
subprogram each time the operation is desired. 

Examples of operations which might be devised as macros include convert 
binary to decimal, delete blank characters or similar operations. Once defined, 
the macro name is used as any other operation code. 

A library macro instruction may be placed in file two of LIB for general use; a 
programmer macro is defined by a programmer for use in a particular 
subprogram. 
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LIBRARY 

MACROS The library macros may be unique to an installation; a list of macros should be 

available to the programmer. When a macro defined in LIB is to be used by a 
programmer, he must declare the macro name in the address field of a LIBM 
psudo instruction immediately following the IDENT pseudo instruction of the 
subprogram. 

Library macros are placed on LIB using the MACRO control statement of 
PRELIB. 


PROGRAMMER 

MACROS 


< symbol > MACRO * • • ’Pn^ 

This statement indicates macro prototypes are to be processed, defines the 
macro name, and declares the formal parameters for the macro. The MACRO 
pseudo instruction does not consume space in the object program. Instructions 
and pseudo instructions follow until the pseudo instruction ENDM terminates 
the prototype. 

Any location defined in the subprogram may be referenced within the macro; 
however, a location within a macro is local to the macro and may not be ref¬ 
erenced from outside the macro. Reference may be made within the prototype 
to symbols external to the subprogram if they are declared by EXT pseudo 
instructions within either the macro or the subprogram. An EXT declaration 
within the macro remains in force for the entire subprogram. 

If the EQU pseudo instruction appears within the macro instruction prototype, 
the symbol in the location field is considered local to the macro and treated as 
any location symbol in the macro. 

The MACRO pseudo instruction must immediately follow the pseudo instructions 
IDENT, LIBM, or MACRO, except that comment cards (asterisk in column one) 
and the pseudo instructions REM or TITLE may intervene. If MACRO follows 
IDENT or LIBM, it defines a macro instruction; and the location field must 
contain a symbol which is the macro name. If MACRO follows a macro def¬ 
inition, it is a formal parameter continuation card; and the location field must 
be blank. 


The programmer may define macros for any subprogram immediately following 
the declaration of library macros, if any. Programmer macros are defined 
only in the subprogram in which they occur and may be referenced within that 
subprogram. 
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MACRO 

INSTRUCTION 

PROTOTYPE 


LOCATION SYMBOL 
IN MACRO 
PROTOTYPE 


FORMAL 
PARAMETERS 
FOR MACROS 


The prototype code for a macro instruction begins with the pseudo instruction 
MACRO and terminates with ENDM. Any mnemonic or octal operation code or 
modifier in the hardware repertoire, any COMPASS pseudo instruction except 
IDENT, LIBM, ENDM, MACRO, or <macro name> may be used for the opera¬ 
tion code field in the prototype. 

The pseudo instructions ENTRY and EXT may appear within the prototype. 
Location symbols within a macro may not be declared as entry point names. 


The location field of an instruction in the prototype may contain a location 
symbol of four characters or less; the location symbol is defined as local to the 
macro prototype in which it appears and will not conflict if used elsewhere in 
the subprogram. Parameters are not passed to the location field. 

<symbol> MACRO > Pg.P^^ 

The first MACRO pseudo instruction must contain a legal symbol of 1 to 8 char¬ 
acters in the location field; the first character must be alphabetic. This symbol 
is the name of the macro instruction, not a location symbol. It may appear 
only in the operation field of instructions in subprograms for which the macro 
instruction is defined. The symbol in the location field should not be the same 
as any mnemonic code in the hardware repertoire, the pseudo instruction list, 
or the name of any other macro instruction defined for the subprogram in which 
this MACRO occurs. If this macro prototype is destined for LIB, the name 
should not conflict with any other macro on LIB. 

Except as noted, the location symbol in the prototype is the same as any other 
COMPASS location symbol. 


Formal parameters declared in the address fields of MACRO pseudo instruc¬ 
tions are referenced in the macro prototype. Formal parameters represent 
elements of code to be defined when the macro instruction is used or called. 

A formal parameter may represent any portion of an instruction or the entire 
instruction except for the location field. This flexibility is attained through the 
use of parentheses as delimiters in processing macro calls. 
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An address subfield or portion of a subfield may be expressed as a single formal 
parameter if that portion of the subfield is set off by a plus or minus sign, a 
comma, a blank or, in the case of VFD, a slash. A BCD or BCD, C pseudo 
instruction, however, may have only the n subfield expressed as a formal 
parameter. 

When the macro instruction is assembled into a subprogram, the macro call 
contains actual parameters to be used when the macro instruction is executed. 
COMPASS transfers the actual parameter to the place at which the correspond¬ 
ing formal parameter was referenced in the prototype. Instructions in the 
prototype are assembled the same as other instructions in a subprogram. 

The list of formal parameters must be enclosed in parentheses and individual 
parameters are separated by commas. Blanks may precede or follow the para¬ 
meter but may not be imbedded. 

The address field of a MACRO pseudo instruction must not extend beyond column 72. 
This does not limit the formal parameter list which may be continued on subsequent 
MACRO pseudo instruction cards provided that three rules are followed. 

Formal parameter continuation cards must have a blank location field. 

The operation field must contain the pseudo-instruction MACRO. 

A formal parameter field and its terminal comma must be contained 
wholly on a single card prior to column 73. 


Formal parameters m3.y appear in an operation code or address field of the 
prototype which follows the MACRO pseudo instruction defining the macro name 
and/or formal parameter list. Symbols in the formal parameter list and the 
prototype are local to the macro instruction and identical symbols may be used 
elsewhere in the subprogram without conflict. The macro name should be unique 
within the subprogram. 


MACRO CALLS <symbol or blank> <macro name> • • • »P ) 

A subprogram may contain any macro instruction defined for the subprogram by 
LIBM and/or MACRO pseudo instructions and prototypes by referring to the 
macro name in the operation code. If the macro is defined for the subprogram, 
COMPASS will assemble and insert the macro code at that point. 

The location field may be blank or contain a symbol which is the relocatable 
address of the first instruction that consumes space in the assembled macro. 

The address field of the macro name instruction provides constants, symbols, 
expressions or Hollerith literals. The actual parameters retain the sequence 
of the formal parameter list in the macro definition. When COMPASS assembles 
the macro, the actual parameters are transferred to the position at which the 
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formal parameters are referenced in the prototype. The address field of a 
single card terminates at column 72 or with a right parenthesis. 

The actual parameter list need not be contained on a single card. It may be 
continued on subsequent cards with blank location field and the macro name 
operation code repeated. An actual parameter must be wholly contained on a 
single card. If the list is not closed by a right parenthesis, an error results. 

The space consumed in the object program by a macro name instruction is 
determined by the prototype and by the conditional pseudo instruction IFZ, IFN, 
IFT, IFF within the prototype. 


MACRO 

NAME ADDRESS 
FIELDS 


Single actual parameters may not include blanks or commas unless the entire 
actual parameter is enclosed in parentheses. If a single actual parameter is 
enclosed by parentheses, it may contain any character legal for the portion of 
the instruction it represents except a right parentheses. Refer to the examples 
An actual parameter may be expressed as zero by providing only the comma. 
Actual parameters not expressed before the list terminates are assembled as 
zeros. 

Actual parameters may not contain entries for location fields in the prototype. 
These fields will not be modified by COMPASS when assembling a macro 
instruction. 

Examples of Macro Definition: 

DIVIDE MACRO 
LDAQ 
DVA 
STQ 
ENDM 

The MACRO is tagged DIVIDE. The set of instructions following is a 
prototype of the instructions to be assembled when DIVIDE is called. 


(P1,P2,P3) 

PI 

P2 

P3 


The address field contains the list of actual parameters enclosed by parentheses. 
Parameters in the list are separated by commas. Single actual parameters may 
also be enclosed by parentheses within the list. This allows an entire instruc¬ 
tion or several subfields of an instruction in the macro prototype to be expressed 
as a single actual parameter. 
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COMPUTE 


MACRO 

(PI, P2, P3, P4, P5, P6, P7, P8, P9) 

LDA 

PI 

LDQ 

PI 

ADA 

P2 

SBAQ 

P3 

VFD 

P4/P5 

P4 

*+ 

DVA 

P6 

STQ 

P7 

LDA 

P7 

P8 

*-P9 

ENDM 



The above example shows how parameters may be specified in the opera¬ 
tion field or the address field, or both, within the macro set of instruc¬ 
tions. It also shows that a parameter may appear more than once in a 
set of instructions. 

JAYSON MACRO (P1,P2,P3) 

LDA PI 

ADA P2 

ST A P3 

ENDM 


JAYSON ( (DOG, 3), CHARLES, CAT) 

Assembled: LDA DOG, 3 

ADA CHARLES 

ST A CAT 

MACRO (P1,P2,P3,P4) 

LDA TOM, 3 

ADA DICK 

STA MARY 

UJP,P2 
PI 

DEC P4 

P3 

ENDM 


BETTY TOSS ((BDC6,A), (I JOE, 2)) 
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Assembled: 


LIBM 


ENDM 


BETTY 


'Y 

LDA 

TOM, 3 


ADA 

DICK 


STA 

MARV 


UJP,I 

JOE, 2 

TOM 

BCD 

6, A 

DICK 

DEC 

0 

MARV 

00 



< blank> LIBM name^,name„, . . . .name 

12 n 

Library macros are stored on LIB via the PRELIB system. LIBM instructs 
COMPASS to call a particular library macro from LIB. LIBM must be contig¬ 
uous to the IDENT pseudo instruction or another LIBM pseudo instruction, 
otherwise an error results. However, comment cards with an asterisk in col¬ 
umn one or the pseudo instructions REM and TITLE may intervene. LIBM does 
not consume space in the object program. 

The location field of LIBM should be blank. A location sjrmbol will be ignored 
by COMPASS but included on the output listing. Subfields in the address field 
contain the names of library macros separated by commas. The address field 
is terminated by the first blank or column 73. 

The programmer may use as many LIBM pseudo instructions as required. 
However, a macro name must be wholly contained within a single subfield on a 
single card. 


< blank > ENDM <blank> 

The prototype of a macro instruction is terminated by ENDM. The location 
field and address fields of ENDM should be blank. A location symbol is ignored 
by COMPASS but included on the output listing. If an entry appears in the 
address field, an error results. 
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CONDITIONAL 

PSEUDO 

INSTRUCTIONS Assembly of instructions and constants from a source subprogram may be con¬ 
ditional as stated by the pseudo Instructions listed below. COMPASS tests for 
the condition and includes subsequent lines of code depending on the outcome of 
the test. 


IFZ 

if zero 

IFN 

if non zero 

IFT 

if true 

IFF 

if false 


The IFZ and IFN pseudo instructions may be used as desired in a subprogram. 
IFT and IFF, which compare a parameter string against stated variables, may 
occur only within a macro prototype. Macros are the only instance of such a 
parameter string which COMPASS can detect. In IFZ and IFN, symbols in the 
address field must be previously defined. Symbols in the third subfield of IFF 
and IFT must also be previously defined. 

IP2 <blank> IFZ m, n 

An arithmetic expression may be stated and tested for zero to determine wheth¬ 
er subsequent instructions should be included in a subprogram. The expression 
must conform to the rules for address expressions. A symbol in the location 
field is ignored by COMPASS but is included in the output listing. 

The address field consists of two subfields. 

m is an expression, the value of which is computed as any address 
expression and evaluated modulo 

n contains an integer or an expression which results in a non- 

relocatable value. 

If the expression in the m subfield results in zero, the following n lines of code 
are assembled into the object subprogram. If the m subfield yields a non-zero 
value, the n lines of code are skipped and do not appear in the subprogram. 
Symbols in the address field must be defined by appearance in the location field 
of a preceding instruction. 

ipisj <blank> IFN m, n 

This pseudo instruction is the same as IFZ except that n lines of code are 
assembled if the value in the m field is non-zero. 
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<blank> IFT m, p, n 


IFT Within a macro prototype, lines of code may be excluded or included in an object 

subprogram using the IFT pseudo instruction. The IFT pseudo instruction 
compares the first two subfields in its address field for literal equality. 

If the two character strings are equal, following lines of code are assembled. 

If they do not compare, the lines of code are excluded from the object program. 

The location field of the IFT pseudo instruction should be blank. If a symbol is 
present it will be ignored by COMPASS but will be printed on the output listing. 
The address field has three subfields. 

m designates the first comparand 

p designates the second comparand 

n must result in a non-relocatable value denoting the number of 

lines of code to be assembled or excluded 

The m and p terms may be character strings or formal parameters; the char¬ 
acter string may not include slashes. If a character string is identical to a 
formal parameter, the string must be enclosed in slashes. Either m or p may 
be expressed as a character string. 

The actual values used in the comparison are obtained by COMPASS as follows: 

If the subfield is enclosed in slashes, the content of the subfield is used 
in the comparison. 

If the subfield contains a formal parameter, COMPASS substitutes the 
corresponding actual parameter before the test is made. 

If the subfield is not a formal parameter and is not enclosed in slashes, 
the character string is used as if slashes had appeared. 

The n term must be a symbol, a constant, or an expression which results in a 
nonrelocatable value. Symbols in the address field must be previously defined. 

If the m and p terms compare bit for bit, the n lines of code immediately follow¬ 
ing the IFT pseudo instruction are assembled into the subprogram. If the m and 
p terms are unlike, the n lines are skipped and not assembled by COMPASS. 

Examples: 

COMPUTE MACRO (PI, P2, P3, P4, P5, P6) 

LDA PI 

DVA P2 

STQ P3 

IFT /P6/, P5, 2 

ENA P4 

ENI P6 

ENDM 
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The following sequence of instructions occurs within a subprogram and the call 
refers to the previously defined macro set. 

STA TABLE 

CAKE COMPUTE (B, C, A, LOCI,P6, 56) 

LDAQ QUANTITY 


The assembler would generate: 


CAKE 


STA 

TABLE 

LDA 

B 

DVA 

C 

STQ 

A 

ENA 

LOCI 

ENI 

56 

LDAQ 

QUANTITY 


Since the actual parameter substituted for P5 is identical to the character 
string "P6”, the assembler includes the two instructions, ENA and ENI. 
The IFT instruction does not appear in the object subprogram. 


STA TABLE 

COMPUTE (B,C, A, LOC2, 54,56) 

LDAQ QUANTITY 


The assembler would generate: 

STA TABLE 

LDA B 

DVA C 

STQ A 

LDAQ QUANTITY 


Since 54 is not equal to the characters enclosed in slashes in the IFT 
pseudo instruction, the assembler does not assemble the two instructions, 
ENA and ENI. Assembly continues with the next instruction from the 
input deck. 

IFF <blank> IFF m,p,n 

The conditional pseudo instruction IFF functions the same as IFT except 
comparands are unlike, the n lines of code are assembled. If the m and p terms 
are identical, the n lines of code are excluded. 
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COMPASS OUTPUT LISTING 


6 


The output listings from COMPASS contain the octal relocatable storage 
addresses and relocatable and/or absolute contents of words in the object 
subprogram. The source code is printed side-by-side with the object code. 
Summaries of relevant information are printed before and after the subpro¬ 
gram code. The representation of the object code on a line of the listing 
depends on the type or class of machine instruction or pseudo instruction 
being printed. 


OUTPUT LISTING 

FORMAT The output listing format is shown in the accompanying table. The title of 

the listing is printed at the top of each page. A title is the subprogram name 
from the IDENT pseudo instruction or a title expressed via a TITLE pseudo 
instruction. The page number is printed in the upper right hand corner of 
each page of output. 

Preceding the body of the subprogram are summaries of: 
undefined symbols 
doubly defined symbols 
external names 
entry point names 

These are followed by storage summaries of 
length of subprogram 5 octal digits 
length of common 5 octal digits 

length of data 5 octal digits 

The subprogram is printed on subsequent pages; COMPASS provides several 
options for incorporating comments and remarks into the source program. 
Listing may be suppressed and resumed. 

Following the source subprogram listing, single precision literals are printed 
three per line; double precision literals are printed two per line. The 5-digit 
octal relocatable address of the literal is followed by the 8 or 16 octal digits of 
the converted number. The number of errors detected in the subprogram is 
printed and the symbol reference table follows as the final COMPASS output. 
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Listing formats are given below: 

Printer Columins Content 
COMPASS Subprogram Listing 


2-8 

error code 

9 

blank 

10-14 

octal relocatable storage address 

15 

character position indicator or blank 

16 

blank 

Machine Language 

Insti-uctions 

17-24 

8 octal digits of the word destined for storage i 
punched into RIF card. The representation is 
shown without regard to relocation. 

25 

blank 

26-27 

2-digit octal operation code 

28 

blank 

29 

content of bit 17 of assembled word; may be 
operation modifier. For 17-bit address 
instructions, the content of bit 17 is printed. 

30 

blank 

31 

alphabetic area relocation indicator 

P - subprogram area 

D - data area 

C - common area 

X - address is part of external string 
blank - absolute value, no relocation 

32-36 

5-digit octal value, either a relocatable word 
address or absolute value 

37 

blank 

38 

a. content of bits 16-15 of instruction which 
may be index designator 

b. content of bits 1-0, character position 
indicator for 17-bit address instructions 

39-40 

blank 

Constants 

25-32 

8-digit octal representation of constants 
assembled into 24-bit words 
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Printer Columns Content 


LISTING 

CONTROL 


REM 


NOLIST 


EQU 

30-34 5-digit octal relocatable address assigned 

to location term of EQU pseudo instruction 

All Lines 

40-119 80-column image of source subprogram 

code line 


The programmer may control COMPASS output listings with the following 
pseudo instructions. The listing control pseudo instructions are written as 
any COMPASS format instruction. 

REM insert remarks 


NOLIST 

LIST 

SPACE 

EJECT 

TITLE 

asterisk 

(card column one) 


suppress output listing 

resume output listing 

space lines on output listing 

eject printer paper to top of next page 

begin succeeding pages with title given 

print card columns 2-80 as a comment 


<any> REM <any> 

Remarks may be inserted into the source program to appear on the output 
listing with this pseudo instruction. All fields except columns 9 to 13 of 
the operation code field may be used for remarks. 

THIS IS REM A REMARK PSEUDO-INSTRUCTION 


<blank> NOLIST <blank> 

This instruction suppresses listing of the subprogram until the pseudo instruc¬ 
tion LIST appears in the source program. Regardless of NOLIST, lines in the 
source program containing errors will be listed. The location and address 
fields are ignored by COMPASS. The pseudo instruction will not appear on the 
output listing. 
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LIST 


SPACE 


EJECT 


TITLE 


<blank> LIST <blank> 

The pseudo instruction LIST resumes output listing after NOLIST has occurred. 
If LIST occurs without a preceding NOLIST, it is ignored. The pseudo instruc¬ 
tion will not appeal' on the output listing. 


<blank> SPACE m 

This pseudo instruction spaces the output listing; the designated number of 
lines are skipped on the printer paper. If as a result of SPACE, the printer 
begins a new page of output, printing resumes with the first line of the new 
page. SPACE instructs the printer to skip m lines or to the top of the next 
page, whichever is less. A symbol in the location field is ignored by COMPASS. 

The parameter m, and unsigned decimal integer, designates the number of 
lines to be spaced. Zero through 32767 lines may be specified. However, the 
upper range would not exceed the number required to move the paper one page. 


<blank> EJECT <blank> 

The pseudo instruction EJECT provides a more efficient way to move to the 
top of the next page. COMPASS will feed the current page through the printer 
and the line succeesding EJECT will be the first line of subprogram information 
on the new page. A symbol jin the location field will be ignored by COMPASS. 
The address field must be blank or an error will result. Remarks may begin 
in column 41. 


<blank> TITLE <i:itle> 

The TITLE pseudo instruction describes a title to be printed at the top of each 
page of a listing. 

If the first page of the listing is to be titled, TITLE must immediately follow 
IDENT. A symbol in the location field will be ignored by COMPASS. The 
contents of columns 20-72 of the address field contain the title. In the body of 
the subprogram, TITLE information replaces the present heading obtained 
from IDENT or preceding TITLE pseudo instructions. The first page follow¬ 
ing the TITLE pseudo instruction will have the new title. If the title is to head 
succeeding information, the pseudo instruction EJECT should be placed immedi¬ 
ately following TITLE; the new page will have the inserted title. 


6-4 



COMMENT 

CARDS 


COMPASS 

ERROR 

MESSAGES 


When COMPASS detects a card with an asterisk in column one, the content of 
the card except for column one is printed on the output listing as a comment. 
No other action is performed. 


If an error occurs in a line of code in a COMPASS source subprogram, an 
error flag is printed on the extreme left of the output listing. These flags 
indicate the field in which the error occurred and, in some instances, the 
exact error. The exact meaning of the flag depends on the particular instruc¬ 
tion or pseudo instruction in which the error was detected. Generally, a field 
containing an error will be assembled as zeros. COMPASS provides nine 
error flags. 

Error Flag 


A Format error in address field. 

Format errors are peculiar to each instruction, 

C Attempt to assemble information into common. 

The flag is given and the instructions are processed as if PEG was 
encountered, 

D Duplicate Symbol. 

The identical symbol has been used in more than one location field 
of the subprogram. The error flag is issued; the original definition 
the symbol holds the second and subsequent instructions using the 
symbol in the location field are assembled as if no symbol occurred, 

F Full Symbol Table. 

a. If the symbol in the location field would overflow the assembler 
symbol table, assembly proceeds after the F error flag is given; the 
F error will be issued for each additional location field symbol in the 
subprogram. All F flagged symbols are undefined and any reference 
to these symbols in address fields of the subprogram will yield a U 
error. 

b. A COMPASS table other than the symbol table may produce this 
error flag but such instances will be rare. 

L Location Field Error. 

Illegal use of symbols in location fields yields an L error flag. The 
error may result from a symbol in the location field of an instruction 
which does not allow it, a missing symbol where one is required, or 
a format error such as imbedded blanks in a location symbol. 

M Modifier Error. 

Error in modifier subfield of operation code field. 
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COMPASS 

CONTROL 

STATEMENT 


PARAMETERS 


O Operation Code Error. 

An unrecognizable operation code occurred; the operation 
field is assembled as zeros. 

U Undefined Symbol. 

A symbol which appears in the address field of an instruction 
has not been defined in a location field. It may be missing 
from a legal location field or because of an F error. 

T Truncation Error. 

A symbol defined as a 17-bit character address is used in a 
subfield consisting of only 15 bits. The error is detected when 
the character address refers to character position 2, 3, or 4. 
The two least significant bits are truncated and the most signifi¬ 
cant 15 bits are used. 


7 

To call COMPASS to assemble source subprograms the SCOPE g<library name> 
statement is used. 

The COMPASS statement has the form: 

7 

g COMPASS, parameters 

The statement has five optional parameters which may be expressed on the 
card; they are free field and are separated by commas. Parameters have the 
general form: option = logical unit number (u in the discussions given below). 

The option must begin with a character I, P, X, L or R. Additional characters 
preceding the equal sign are ignored, thus L and LIST are the same parameter. 
If only the option is stated, COMPASS will make a standard assignment for the 
option. 


INPUT = u 

Source subprogram input unit; if the parameter or unit equation is absent, 
input from the standard input unit, INP, is assumed. 

PUNCH = u 

Punch option, u represents a logical unit number assigned to an output device. 
If the parameter is absent no punchable binary output will be produced. If only 
P appears, binar}'^ output will be produced on the standard punch unit, PUN. 

XECUTE = u 

Binary output for load-and-go option, u represents a logical unit number 
assigned to a magnetic tape unit. If the parameter is absent, no load-and-go 
tape will be written. If only X appears, binary output will be produced on the 
standard load-and-go unit, LGO. 
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LIST = u 

List option, u represents a logical unit number assigned to an output device. 
If the parameter is absent, no listing will be produced. If only L appears, 
the listing will be produced on the standard output unit, OUT. 

REFERENCE 

If one of the COMPASS parameters is R, a symbol reference list is printed 
on the output listing. The symbol reference list in alphabetic order shows 
the s3mibol with its assigned address or value. The addresses are prefaced 
by an area relocation indicator. 
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SCOPE ORGANIZATION OF I/O 


PROGRAMMER 

UNITS 


Under SCOPE, input/output devices are specified by logical unit numbers 
The logical units are organized according to function and the programmer or 
the operator assigns the logical unit to a particular type or unit of hardware 
through SCOPE control statements. Input/output operations may be independent 
of a particular configuration of hardware or t 3 ^e of input/output device. The 
logical unit may be assigned to any hardware unit, provided that equipment has 
the capability required by the logical unit. 

Logical units are programmer units, scratch units, and system units. Pro¬ 
grammer units are unrestricted as to use for any run in a job. Once defined, 
the definition of the programmer unit is fixed for the entire job. When a new 
job is encountered, all programmer units are released. Scratch units must be 
defined for each run and are released at the end of the run. Scratch units are 
assigned and used by library programs as required and may be used by the 
programmer. 

System units are assigned to specific physical equitment within SCOPE but 
these assignments may be altered by the operator. System units are used for 
certain common functions; they are referenced by SCOPE and may be refer¬ 
enced by the programmer. When jobs are stacked, SCOPE protects system 
units from input/output requests which might destroy their contents or position 
the units to the detriment of the jobs. Protection is not provided when jobs are 
not stacked. 

All logical units are referenced by a number, 1 through 63. Certain mnemonics 
are associated with the system units, they simplify discussion, but they are not 
interpreted by SCOPE. 

At the option of the programmer, system units may be protected by SCOPE. 
However if protection is not desired, the programmer may so state in the JOB 
statement. Non-stacked jobs always have unprotected I/O. In the discussion 
of logical units, protection is assumed. 


These units are for general purpose use of the programmer. They are released 
at the end of the job unless saved by the programmer. Programmer units are 
numbered 1-49. 
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SCRATCH 

UNITS 


Scratch units are for temporary use by the programmer. They are released 
at the end of the run. Scratch units are numbered 50-55. 


SYSTEM 

UNITS 


Selection of density on the following units, except LGO, is ignored when protec¬ 
tion is active. The request containing the density statement is processed 
according to the usual procedures in all other respects. 


Logical 

Unit 

Number Mnemon ic Description 

56 LGO Load and Go. 


57 


58 


59 


Object programs produced by assembly or compila¬ 
tion or transferred from another unit, may be stored 
on the LGO prior to loading and execution, LGO 
must be defined in each job. The unit is released 
after the object programs have been loaded; it may 
then be used as a scratch unit. 

ACC Accounting record. 

ACC is defined by installations keeping an accounting 
record. SCOPE does not use the unit. 

CFO Comment from operator. 

The operator communicates with SCOPE or other 
programs via CFO. Only READ requests are 
allowed for CFO. I/O protection assumes that CFO 
is the console typewriter, a buffered typewriter, or 
an on-line card reader. If CFO is equated to stand¬ 
ard input, 60, protection is defined by that unit. 

CTO Comment to operator. 

The operator receives comments from SCOPE or 
other programs via CTO. Only WRITE requests are 
allowed on CTO. If CTO is equated to OUT, 61, 
protection is defined by that logical unit. CTO is 
assumed to be a console typewriter, a buffered type¬ 
writer, or an on-line printer; protection is based on 
this assumption. 
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Logical 

Unit 

Number 


Mnemonic 


Description 


60 INP Standard input. 

Protection for this logical unit prevents 1/O requests 
which would destroy information or position the unit 
so that information pertinent to the current job would 
be lost. Specifically, if INP is assigned to magnetic 
tape, WRITE, REWIND, UNLOAD, SEFF, SEFB, 
WEOF and ERASE requests are prohibited. If the 
end-of-file status line is on, requests may be issued 
as shown: 


Last Request 

Request Allowed 
READ READB BKSP 

READ 

no 

yes 

yes 

READB 

yes 

no 

yes 

BKSP 

no 

no 

no 


61 OUT Standard output. 

OUT holds listable output from SCOPE and other 
programs. Protection is the same as specified for 
PUN below. 

62 PUN Standard punch. 

PUN receives punchable output from library pro¬ 
grams such as COMPASS or FORTRAN. It may be 
used by programmers for other punch purposes. 

When a WRITE or ERASE request is issued for OUT 
or PUN, SCOPE checks for end of tabe. When it is 
detected the reel is closed and the unit is unloaded. 
Closing a PUN reel consists of writing two end-of- 
file marks and the one-word BCD record, ERaa . 

A message — "LOAD NEW XX" — is written on CTO. 
SCOPE waits for the unit to be reloaded. 

Protection for PUN and OUT assumes these units 
are assigned to magnetic tape. Only the programmer 
requests,WRITE, BKSP and ERASE are allowed; 
BKSP is allowed only following WRITE or ERASE. 
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INPUT/OUTPUT 

REQUESTS Input/output requests are written in COMPASS programs as calling sequences 

for monitor routines controlled by a central input/output routine, CIO. CIO 
performs the follovi/ing functions: 

Selects an available channel. 

Rejects a request if neither the unit nor any channel through which it may be 
accessed is available, or if an illegal function code is given. 

Furnishes status for all requests. 

Initiates input/output operations and returns control so that processing may con¬ 
tinue while the operation is performed. 

Responds to external interrupt and transfers control to a user specified 
interrupt subroutine. 

The machine instructions for input/output operations should not be used when 
running a program under SCOPE. 


CALLING 

SEQUENCE 


Input/output operations are specified by entering an octal function code and 
other parameters into a calling sequence. The function code defines the 
operation. 


Function 


Code 

Request 

01 

READ 

02 

WRITE 

03 

READB 

04 

REWIND 

05 

UNLOAD 

06 

BKSP 

07 

SEFF 

10 

SEFB 

11 

WEOF 

12 

ERASE 

13 

STATUS 

14 

FORMAT 

BCD 

Binary 

Low 

(200bpi) 

Medium 

(556bpi) 

High 

(SOObpi) 


Valid Unit References 
if Protection Selected 

1-58, 60, 63 
1-57, 59, 61, 62 
1-57, 60, 63 
1-57, 63 
1-57 

1-57, 60-63 
1-57, 63 
1-57, 63 
1-57 

1-57, 61, 62 
1-63 

1-63 

1-63 

1-56 

1-56 

1-56 
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The input/output operations are; 
Function 


Code 

Mnemonic t 

Operation 

01 

READ 

read n words starting at first word 
address 

02 

WRITE 

write n words starting from first 
word address 

03 

READS 

read n words backwards and store 
backwards starting at first word 
address + n - 1 

The input/output operations are 

requested by the calling sequence; 

L 

RTJ 

CIO 

L+1 

function code 

logical unit, interrupt indicator 

L+2 

jump 

reject address 

L+3 

mode 

first word address 

L+4 


number of words 

L+5 


interrupt address 

L+6 

normal return 


The tape control operations are: 

Function 

Code 

Mnemonic t 

Operation 

04 

REWIND 

rewind 

05 

UNLOAD 

unload 

06 

BKSP 

backspace one record 

07 

SEFF 

space forward past one end-of-file 
mark 

10 

SEFB 

space backward past one end-of-file 
mark 

11 

WEOF 

write end-of-file mark 

12 

ERASE 

erase 

t Mnemonics are used for discussion 

purposes only; they are not interpreted by SCOPE, 
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The tape control operations are requested by the calling sequence: 


L 

RTJ 

CIO 

L+1 

function code 

logical unit, interrupt indicator 

L+2 

jump 

reject address 

L+3 


interrupt address 

L+4 

normal return 


The imit STATUS operation function code is 13. Unit STATUS is requested by 
the calling sequence: 

L 

RTJ 

CIO 

L+1 

function 

logical imit, dynamic flag 

L+2 

normal return 


When a STATUS request is made, SCOPE provides the status in the Q register 
and the unit condition in the A register. 

The FORMAT selection function code is 14. Unit FORMAT selections are 
requested by the following calling sequence: 

L 

RTJ 

CIO 

L+1 

14 

logical unit, format code 

L+2 

jump 

reject address 

L+3 

normal return 



CIO must be declared as an external symbol in the source 

subprogram 

Function 

PARAMETERS code octal number, 1-14, designating the function to be performed 

Logical unit 

number may be 1-63 depending on function code 
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Interrupt 

indicator 


selects interrupt on normal or abnormal end of operation 


2 

Mode 


First word 
address 


Number of 
words 


Reject 

address 


Dynamic 

flag 

Jump 


0 no interrupt 

1 interrupt on abnormal end of operation only, includes 

end-of-tape, end-of-file mark, load point, parity error, 
and lost data for magnetic tape and equivalent conditions 
for other hardware 

or 3 interrupt on end of operation, normal and abnormal 

designates the recording mode in octal. If no mode is desig¬ 
nated, binary mode is assumed and density is under control 


of the 

1 operator. 

00 

do not select a new mode 

40 

no density, even parity 

41 

no density, odd parity 

50 

low density, even parity 

51 

low density, odd parity 

60 

medium density, even parity 

61 

medium density, odd parity 

70 

high density, even parity 

71 

high density, odd parity 


symbolic word address of the first word in the input or output 
buffer area 


decimal number specifying the number of words to be 
transmitted 


symbolic word address; control returns to location L+2, if the 
request is rejected 


if non-zero, the hardware unit is interrogated for status uncon¬ 
ditionally (see STATUS requests) 

any legitimate jump to the reject address 
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NORMAL 

RETURNS 


REJECT 


INTERRUPT 


UNIT STATUS 
REPLIES 


Interrupt address of closed interrupt subroutine to which control is 
given when the specified interrupt occurs. If no interrupt 
is requested the normal return is written in location L+5 
for function codes 1-3, and in location L+3 for function 
codes 4-12. 

Code tape format selection, any not listed below are illegal 


BCD 

4 Medium 

Binary 

5 High 

Low 



SCOPE initiates the operation specified by the calling sequence and returns 
control to the normal return so that processing can continue while the operation 
is performed. When control is given to the normal return, the Q register con¬ 
tains the status of the logical unit. 


An input/output or tape control request can be rejected because the unit is 
unavailable, no channel isn.vailable, or the function code is illegal for the type 
of equipment. Upon reject for unit or channel unavailability, the A register is 
zero; for an illegal function code, the A register is non-zero. For any reject 
return, the Q register contains status of the unit. 


If an interrupt address is specified and the interrupt indicator is non-zero, 
control transfers to the interrupt address at the end of the operation or upon 
abnormal condition interrupt. Before giving control to the interrupt address, 
SCOPE saves the A, Q and three index registers ; and it enters the current 
condition and status of the unit in the A and Q registers. Control transfers to 
the interrupt address by a return jump. This address usually contains an 
unconditional jump. The programmer transfers control to SCOPE from the 
interrupt routine by returning through linkage established by the return jump. 
Upon regaining control, SCOPE restores the A, Q and index registers and 
returns control to the running program. 


When a STATUS request is made or when control transfers to normal, reject, 
or interrupt address, the Q register contains information on the status of the 
unit. 
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23 2221 1918 1716 _0 



ic 

r 


status 


is 


ic 


r 


indicates logical status 

00 for STATUS request: unit is static; channel 
available 

for reject return: hardware reject 

for normal return (non-STATUS): unit is 
dynamic 

01 channel is not available for I/O or STATUS 
request processing 

10 previous operation is incomplete 

11 previous operation is complete but unit inter¬ 
rupt 15 is required for executing user inter¬ 
rupt request 

is the last channel to which unit was connected. 
It may or may not still be connected to this 
channel. 

status of unit (as shown in the table) — If the 
unit is dynamic; current unit status at the time 
of the request is given. If the unit is static it 
reflects the results of the last completed 
operation. 

is the retention code key obtained from first 
record of a labeled tape. 

1 tape contains a retention code in the label 

indicating the contents of the tape should not 
be destroyed. 

0 tape may be us'^d for output. 


7-9 





7-10 









































































UNIT CONDITION 
REPLIES 


INPUT/OUTPUT 

CONTROL 


TAPE CONTROL 


When a STATUS request is made or when control transfers to the normal inter¬ 
rupt address, the A register indicates the current condition of the unit. 


23 22 


16 17 


0 



c 


n 


tea 


is the condition 
1 unit is static 

0 unit is d3niamic 

is the last function code (other than STATUS, 
13) given for this unit. 

is the termination character address of data 
transmission contained in the Buffer Control 
Register. 


CIO controls the input/output channels. A channel is released for further oper¬ 
ations as soon as possible; and hardware which can be connected to more than 
one channel is used to the best advantage. 

Read, write, and read backward operations require the channel throughout 
execution. When an input/output operation is initiated the channel becomes 
busy. When an operation is completed, the channel is free and the unit status 
is recorded. If the user requests an end of operation interrupt ; control passes 
to the specified interrupt subroutine; or if only an abnormal end of operation 
interrupt is requested, control transfers to the interrupt routine when an 
abnormal condition occurs. 


The direction of tape motion after a backspace request depends upon whether the 
last read operation was read or read backward. If backspace is given after read 
backward, the tape moves forward one record. Other motion requests indicate 
true direction of tape motion and are not affected by read backward. 

Tape control operations require the channel only during initiation of the function 
and do not cause the channel to be busy. If the user requests an interrupt at the 
end of a tape control operation, however, CIO considers the channel to be busy 
until the interrupt occurs. 
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STATUS 


Status checking does not involve any action on the unit. It may require use of 
a channel to interrogate the unit if the unit is dynamic or dynamic STATUS is 
requested. 

The unit is busy when it is performing an input/output or tape control operation. 
It is also considered to be busy if a tape control operation without interrupt has 
been initiated but its completion cannot be determined because all available 
channels have become busy through other operations. Status of the unit is 
given with respect to the user's ability to reference it. 

For input/output operations, a unit is not busy after interrupt occurs. For tape 
control operations, a unit may be determined to be not busy during execution of 
a status request if a channel is available to sense the equipment status. 

When status is requested, the current status is given if the unit is busy. When 
the unit is not busy, the status reply contains information about the operation 
last completed. 

A user may demand that the unit be interrogated by setting the dynamic flag in 
a STATUS request. The current status is returned to the user. If a channel is 
available, the unit is connected (if not still connected as a result of a previous 
operation), and the unit status is copied. If no channel is available only the 
logical status is provided. 

CAUTION: If the unit must be connected to obtain its status, the status lines 
carrying lost data signals are cleared by the hardware when a connect is issued. 

EXAMPLES of input/output: 


LOCATION 


EXT CIO 

RTJ CIO 

01 12, 3 

UJP REJECTl 

READAREA 
9 

INTROUT 


NEXT 

CIO must be declared as an external symbol. A read operation (function code 
01) is to be performed on logical unit 12. Nine words are to be read starting at 
READAREA. After the operation is initiated, control transfers to the normal 
return at NEXT and the A and Q registers contain information about logical 
unit 12. 
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If the unit or channel is unavailable or the function code is not valid, control 
transfers to LOCATION which contains an unconditional jump to REJECTl. 

When unit or channel is unavailable, the A register is zero. When the function 
code is illegal, the A register contains the function code, or 77777 if an attempt 
was made to use a 00 fimction code. The Q register contains the current condi¬ 
tion of logical unit 12. If the request is honored, control transfers to the inter¬ 
rupt subroutine at INTROUT when the data transfer is completed. The A, Q 
and index registers are saved. At that time, updated current status for logical 
unit 12 is available in register Q and the condition in register A. A new mode 
is not selected. 


EXT 

RTJ 

4 

LOC UJP 


CIO 

CIO 

20 

REJECT 4 


GOON 

CIO is declared as an external symbol. Rewind (function code 04) is initiated on 
logical unit 20. Since no interrupt is chosen (interrupt indicator is zero), no 
interrupt address is specified and the channel is available for another operation 
once rewind is initiated. After rewind is initiated, control transfers to the 
normal return at GOON and the Q register contains the status of logical unit 20. 
For reject, control returns to LOC; the A register contains zero for unavailable 
unit or channel and non-zero for illegal function code, the Q register contains 
the updated status of logical unit 20. 

STATUS Example: 

EXT CIO 


RTJ CIO 

13 25 

CONTINUE 

STATUS (function code 13) is requested for logical unit 25. The updated status 
for logical unit 25 is in the Q register; the current condition of unit 25 is in the 
A register. Control returns to CONTINUE. 
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REJECTED I/O 
REQUESTS 


Any input/output request except STATUS can be rejected. Conditions which 
return control to the reject address are the following: 


illegal function C!ode 
illegal format request 
channel busy 
unit busy or not ready 
hardware reject 
interrupt not processed 

The updated status words are in the A and Q register when the return is to the 
reject address. On a normal return, the registers contain the status of the 
unit prior to honoring the request. 

When the reject occurs the programmer must have considered the particular 
unit in planning remedial action. The hardware requires different action 
depending on type and model. The remedial action must take this into account. 
The response to a reject may consist of several actions: 

ignore the request and allow the program to proceed 

take alternate action such as simulation of the request 

instruct the operator to action that would enable the request 
to be executed, i. e. , make the unit ready 

terminate the program 
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TYPES OF REJECTS 


On the return to the reject address the A register is a flag. If A contains a 
non-zero value, the reject was caused by an illegal function code and the illegal 
code is in A, If the illegal function code was zero, A contains 77777g. 

If A is zero the program must examine the is bits of the UST word in Q, 

is Meaning 

OOg Hardware reject. Any of the conditions noted for external 
rejects in the appropriate hardware reference manual 
occurred. Generally, the unit is (busy)*, which state is 
defined by the unit. It is a matter of timing and the type of 
indication supplied by the unit. This return usually indi¬ 
cates a hardware malfunction or disturbance of the control 
information used by EIO. 

OI 2 Channel busy. 

The channel is busy but the unit is free. The channel may 
be in use by another unit or SCOPE/CIO has been given 
inaccurate or inadequate information. The tables may have 
been altered by a program or the operator. 

IO 2 Unit busy or not ready. 

The channel is free but the unit is busy. The unit may be 
busy because some previous request is still in process. 

For example, the final data transmission is not complete 
or a rewind or backspace is in process. The unit may be 
not ready which may require operator intervention depending 
on the unit involved. 

II 2 Both unit and channel busy. 

This reject occurs when the programmer has specified 
an interrupt subroutine for a previous operation on the 
same unit, and the interrupt subroutine has not been entered. 

The interrupt is available but the interrupt system has been 
disabled by entry to CIO or by the user. The only recovery 
is to enable the interrupt system or to terminate the job. 
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SCOPE CONTROL STATEMENTS 8 


SCOPE is directed toward efficient control of hardware and programs by pro¬ 
grammer and operator. SCOPE control statements specify the services for 
program execution; they allow the user to establish the peripheral equipment 
required and to call and operate library programs, or to load relocatable binary 
programs and operate them. SCOPE provides diagnostic routines and error 
checking. 

SCOPE control statements consist of a statement name or mnemonic and param¬ 
eters necessary to define the operation. Control statements may be read in 
sequence from the Standard Input unit, or may be serially presented by the 
operator. The operator enters them via the Comment From Operator unit 
which is usually the console typewriter. If a control statement has specific 
parameters and all are expressed, the final parameter may be terminated by 
a comma and comments placed following the parameter list. The restricted 
field control statements are: 

SEQUENCE 

JOB 

XFER 

LOAD 

ENDSCOPE 

SNAP 

Examples: 

^SEQUENCE, 426, COMMENT 
gJOB, c,i, t, COMMENT 
gXFER, 20, Tins IS A COMMENT 


SCOPE CONTROL 

CARDS SCOPE control cards contain a 7, 9 punch in column one; there must be no 

other punches in column one. Columns 2 through 80 contain Hollerith informa¬ 
tion or blanks. The first information in the card must be the statement name; 
parameters are separated by commas. Except for these restrictions the card 
is free field. 
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INPUT DECK 
STRUCTURES 


Operator control statements are allowed once per job. Programmer control 
statements are inserted at appropriate points in the job deck. A flow diagram 
at the back of this manual shows the mandatory sequence of control statements 
in a programmer deck. In certain instances, functions obtained by various con¬ 
trol statements are shown. The major purpose of the diagram is to show the 
proper position of control statements in programmer decks. 


Job input to SCOPE is on the standard input unit, INP. Assuming that INP is 
magnetic tape and that jobs are stacked, the input would consist of job decks 
each preceded by a SEQUENCE statement and terminated by an end-of-file. 

The SEQUENCE statement must be followed immediately by a JOB statement. 

A stack of jobs on INP appears as follows: 

^SEQUENCE, j 

7 NS 

gJOBc,i,t,^p,ND 

control statements 
programmer decks 
control statements 

gRUN.t, NM 

data 

EOF 

^SEQUENCE, . . . 

^JOB. . , . 

EOF 

^SEQUENCE, . . . 

^JOB. . . . 

EOF 

gSEQUENCE, . . . 
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SEQUENCE 


JOB, . 


EOF 

^ENDREEL 

y 

EOF 

or 

gENDSCOPE 

EOF 


(SCOPE will request next reel) 


(no additional reels for INP exist) 


The first statement on INP must be SEQUENCE. If JOB is not the next state¬ 
ment, the job is terminated and SCOPE moves INP until an end-of-file is 
detected. The following statement must be SEQUENCE, ENDSCOPE, or 
ENDREEL. If JOB follows SEQUENCE, SCOPE proceeds normally. 

When a SEQUENCE statement is detected, SCOPE activates CFO to receive 
operator control statements. 

Any of the statements listed below may follow the JOB statement: 


EQUIP 

UNLOAD 

CTO 

<library name> 

XFER 

<loader card> 

REWIND 

LOAD 


Following LOAD and loader card, these statements only are allowed: 

CTO OCC 

REWIND SNAP 

UNLOAD RUN 


gSEQUENCE, j 

The sequence statement assigns a number, j, from 1 to 999, to the job which it 
precedes. The SEQUENCE card is normally supplied by the computer operating 
facility; it is mandatory before each JOB card. An end-of-file must precede 
each SEQUENCE statement except the first on INP. 
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When the SEQUENCE statement is detected, the card is logged on CTO. End- 
of-file is written on OUT and PUN, if it is assigned, and all programmer units 
from the last job are released. Entry to the installation accounting routine 
completes the last job. The parameter j, is placed into ACCOUNTS. SCOPE 
requests operator control statements via CFO and processes them. The param¬ 
eter, j, is the number referenced by the operator control statement, SEQUENCE. 

Example; 

EOF 

^SEQUENCE, 4 

y 

>B. ... 


EOF 

^SEQUENCE, 88 
^JOB. . . . 


EOF 

^SEQUENCE, 3 

'job. . . . 


JOB 


7 

JOB, c,l, t, or, ND 
^ NP 

c charge number, 0-8 characters 

i prog]?ammer identification, 0-4 characters 

t job time limit in minutes for entire job 

This includes idle time for setup as well as running time. 
The maximum time for job depends on the installation 
accounting routine. 
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ENDSCOPE 


ENDREEL 


NS indicates a single non-stacked job. If chosen, NP is 

implied. All system tape units are rewound and unloaded, 
making all I/O vmits available to the programmer. 

NP suppresses system I/O protection 

ND suppresses post-execution dump 

Jobs submitted for processing under SCOPE require a JOB statement which 
supplies information to the installation accounting routine, identifies the pro¬ 
grammer, and sets a job processing time limit. The JOB card must be 
immediately preceded by a SEQUENCE statement. 

The c, i and t fields are mandatory. If one of the fields is blank, the comma 
delineating the field must appear, otherwise the job is terminated. The JOB 
card is written on OUT; and if the job is part of a stack, on CTO also. 

If a job is terminated abnormally, a post execution dump of all non-system 
memory is written in octal on the standard output imit, unless ND appears on 
JOB card. 


gENDSCOPE 

The ENDSCOPE statement indicates that a SCOPE run is to be terminated. 
When ENDSCOPE appears on INP, the statement should follow the end-of-file 
terminating the last job of the stack. The card is logged on CTO, INP is 
unloaded. LIB is rewound and entry to the installation accounting routine is 
enabled to close the file. Finally, a double end-of-file and one BCD word of 
ER^^ are written on OUT and OUT is unloaded. If PUN is assigned, it is 
treated in the same manner. If ACC differs from OUT or PUN, it is handled 
by the installation accounting routine. 

When all action is completed, the computer halts. ENDSCOPE may be entered 
from CFO to terminate a SCOPE run arbitrarily. 


gENDREEL 

The ENDREEL statement terminates a reel of magnetie tape containing a job 
stack. Normally this statement is placed in the job stack by the operator during 
card to tape operations when preparing a tape to be used as INP. SCOPE 
requires an end-of-file immediately before and immediately after ENDREEL. 
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CTO 


REWIND 


SCOPE accepts ENDREEL under the same condition in which it would accept 
SEQUENCE or ENDSCOPE. When ENDREEL is encountered on INP, SCOPE 
prints a message on CTO requesting the operator to mount the next reel of 
INP and halts the computer until the operator take action. 

Example of stacked input on magnetic tape: 

^SEQUENCE, . , . 

Ijob, . . . 

job deck 

EOF 

^SEQUENCE, . . . 

y 

gJOB,. . . 


EOF 

^ENDREEL 

y 

EOF 


^CTO, data 

y 

The programmer may provide instructions and messages to the operator with 
the CTO statement. The programmer may add Hollerith data following CTO. 
CTO cards may appear anywhere in a deck except next to the statements 
SEQUENCE, ENDSCOPE and ENDREEL, or between a SEQUENCE and a JOB 
statement. The CTO statement is logged on CTO and OUT. 


gREWIND, . . . , u. 

The REWIND statement rewinds a magnetic tape to load point on logical unit u, 
1 to 56. 
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UNLOAD 


EQUIP 


HARDWARE DEFINITION 


EQUATE LOGICAL 
UNITS 


This statement is copied on OUT and CTO. If u is not 1 to 56, or not magnetic 
tape, the request is ignored for that unit and the remainder of the statement is 
processed. Unit assignments are not altered. 


gUNLOAD, u^, u^, Ug, . . . , Uj 

Logical units, u, 1 to 56, may be unloaded by the programmer. The UNLOAD 
statement is handled in the same way as REWIND except that the unit is 
unloaded after it is rewound. 


^EQUIP. x^=d^. X2=d2.Xj = d. 

The EQUIP statement may be given prior to loading a program for a run. Refer 
to the SCOPE flow chart. It includes declarations, d, regarding logical units 
(1 to 56). 


gEQUIP, x=hh 

This statement defines hardware type, hh, for a logical unit, x; 


Mnemonic 

Hardware Type 

MT 

magnetic tape 

CR 

card reader 

PR 

printer 

CP 

card punch 

TY 

console typewriter 

PT 

paper tape station 


The designated logical unit is assigned to an available equipment of the speci¬ 
fied hardware type- If hardware of the designated type is not available, a diag¬ 
nostic will result. The job is terminated. 


^EQUIP, Xj-X^ 

Logical units, x., are equated by this statement. A system unit (57-63) may not 
be specified in tKe left side of the statement; if it is, the job will be terminated. 
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PHYSICAL UNIT 
ASSIGNMENT 


XFER 


gEQUIP, x=hhCcEeUuu 

c channel number 0-7, prefixed by C 

e equipment number (controller), prefixed by E 

uu unit number (device), prefixed by U 

This form of the EQUIP statement offers the options shown. Blank spaces 
indicate parameters which may be omitted. 


hh 

Cc 

Ee 

Uuu 

X 




X 

X 



X 

X 

X 


X 

X 

X 

X 


X 

X 

X 


X 

X 



Use of a non-existent channel, equipment, or unit number will cause a diagnos¬ 
tic to be printed and the job to be terminated. 

If more than one logical unit is to be assigned to the same I/O device, the first 
logical unit must be assigned to the device and the logical units equated. To 
assign PUN and LGO to the same physical tape the following statements could 
be used. 

gEQUIP, 62=MT COE VOS 

JeQUIP, 56=62 
9 

gEQUIP, 62=MTC0EV03, 56=62 is also legal. 


gXFER, u 

The logical unit number u, (1-56) may be undefined or defined as magnetic 
tape. If u is defined as equipment other than magnetic tape, a message is 
written on CTO and OUT, the job is terminated, and SCOPE proceeds to the 
next SEQUENCE statement on INP. If u is undefined, it is assigned to the 
first available magnetic tape, the assignment is logged on CTO and the system 
waits for the operator to continue. 
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LOAD 


SCOPE transfers information following the XFER statement and preceding the 
next control statement, from INP to a magnetic tape. The records are written 
in odd parity. SCOPE writes an end-of-file mark and backspaces over it when 
the succeeding SCOPE control statement is encountered. 

Programmer data cards may be transferred from INP to another tape unit using 
XFER. A card or card image with a 7, 9 punch and no other punches in column 
one terminates the XFER operation; control is maintained by testing for a 
SCOPE control card. 

Binary object subprograms may be transferred from INP to another tape unit 
using XFER. If this unit is a programmer or scratch unit, it must be rewound 
before it can be loaded. 

Example; 

gXFER, 25 

data 

7 

gSCOPE control statement 

The binary information on INP is written in odd parity on logical unit 25 fol¬ 
lowed by an end-of-file mark. 


9 LOAD, U^.u^, Ug 

The logical units, Uj, are logical unit numbers 1-56, previously defined by an 
EQUIP statement for this run. If omitted, the loader attempts to load from 
INP, 60. No more than three units may be specified. 

This statement calls the loader to load binary subprograms into memory from 
programmer units, scratch units, LGO or INP. Only one LOAD statement may 
appear per run. 

An end-of-file terminates loading from each unit. SCOPE loads from the units 
in the order in which they appear and then loads binary information from INP, 
if any exists. Since the loader operates only once per run, the LOAD state¬ 
ment must precede any binary object subprograms to be loaded from INP for 
the same run. Multiple files may be loaded from the same unit by repeating 
the unit designation in the LOAD statement. 
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If 56 (LGO), is specified as one of the three unit declarations, it will be rewound 
SCOPE before the loader is entered. If programs are loaded from LGO, it 
will be released at the end of the run or the programmer may unload and save it. 
CTO statements may be used to inform the operator of proper handling. If LGO 
is not to be saved, it may be rewound and used as a scratch unit by the loaded 
program. 

With or without a LOAD statement, a binary object subprogram on the standard 
input unit is loaded into memory when encountered by the monitor system, 
unless it is preceded by a control statement such as XFER, which specifies 
some other processing. All binary program cards before the next SCOPE con¬ 
trol statement are loaded. If there is a LOAD statement for the same run, it 
must precede the binary object subprograms on INP. 

Examples: 

^LOAD, 56, 3, 25 
IJ 

LGO, 5 6, is rewound by SCOPE and subprograms are loaded until an end- 
of-file mark is encountered. Subprograms are loaded from units 3 and 
25 to an end of file. 

LGO may be rewound and used as a scratch unit if it is not to be saved. Any 
binary subprograms on INP preceding a SCOPE control card are loaded fol¬ 
lowing the tape loading operation. 


gLOAD, 2 

Logical unit 2 is loaded until an end-of-file mark. Logical unit 2 is not 
moved except by loading. INP is loaded until a SCOPE control card is 
encountered. 

gLOAD 

Binary subprograms on INP are loaded until a SCOPE control card is 
encountered. This use of LOAD is optional; the subprogram would be 
loaded if this statement did not appear. 

Typical job deck with XFER: 
gJOB, c,i, t 

gEQUIP, u =d u =d . . . , u =d 
^ 112 2 n n 
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^XFER, u 
9 


LIBRARY NAME 
STATEMENT 


LOADER CARD 
AS CONTROL 
STATEMENT 


binary object subprograms 
data cards 

7 

gCOMPASS, assembly options 

source subprograms 
FINIS 


gKEWIND, u^, .u. 

’load, u^. u^, Ug 

binary object subprogram 

gRUN, t, NM 

7 

g<library name >, parameters 

<library name > the program is in file two of LIB 

parameters Parameters to the called library program 

which are passed to the system by SCOPE. 

Library programs may be called, loaded and executed by the programmer 
using this statement. The <library name> is the entry point to a system on 
the library tape such as COMPASS, FORTRAN, or COBOL. User programs 
may be placed on LIB and called in the same manner. 

Example; 

^COMPASS, I, P, X, L, R 


The programmer may place binary subprogram cards in the appropriate place 
in his deck. These cards are placed on INP. No LOAD statement is required, 
When SCOPE detects a binary subprogram card, recognized by punches in at 
least one of the rows 3, 2, 1, 0, 11, 12 of column 1, the loader is called and 
reads INP until a SCOPE control card is encountered. Refer to Appendix A 
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RUN 


gRUN t, NM 


t is the execution time limit in minutes, 0 ^ t ^ 999. It is entered 
into the ACCOUNTS table for use by an installation accounting 
routine. It is not used by SCOPE. If omitted maximum time is 
assumed. 

NM suppress the memory map that would otherwise be written on OUT. 
The map wMch lists memory allocations of a loaded program is 
written on OUT prior to execution of the program. 

The RUN statement initiates program execution by transferring control to the 
object program in memory. The RUN statement is required for all programmer 
runs. 

Example: 

gRUN, 2 

the execution time limit is estimated 2 minutes. The memory map will 
be written on OUT. 

The RUN statement follows the relocatable binary decks if the program is on 
INP or the LOAD statement if the program is on an input tape other than INP. 
The RUN control card is copied on OUT and CTO. 

If the program runs successfully and the job is stacked, the next run (if any) in 
the job is processed. If the run is unsuccessful, the entire job is terminated. 
Non-stacked jobs may contain only one RUN statement. Non-stacked jobs end 
with an appropriate message and the computer halts. 


7 

gOCC, location, octal correction, . . . , octal correction. 

Octal corrections may be made to binary subprograms after loading. The OCC 
statements may be used to define and enter corrections or additions to subpro¬ 
grams by establishing a program extension area. 

The program extension area is created after the subprogram area. Corrections 
to subprograms referring to the extension area, or instructions to be stored in 
the extension area may not be submitted until all subprograms have been loaded. 

The parameters are free field. If the optional period is used to terminate the 
card, comments may follow it. 
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Location 


Meaning 

program name k Corrections on this OCC card are loaded begin¬ 
ning with location k in the named subprogram. 

Dk Corrections are loaded beginning with location 

k in the Data area. 

Xk first occurrence: 

Define a program extension area of length k. 
Corrections on the first card with X in the 
location field are ignored. 

subsequent occurrences: 

Corrections are loaded beginning with loca¬ 
tion k of the program extension area. 

4k Continuation OCC cards. 4-k is an increment 

from the last location plus one corrected by 
the previous OCC statement. 

Octal corrections, up to 8 octal digits, follow the location term and are set 
off by commas. Blanks may be included. Leading zeros may be omitted. 
They contain an octal value of up to 8 digits or an octal value and a relocation 
factor. 

Each value is stored right justified in successive computer words. If a value 
of less than 8 digits is supplied, the computer word is zero filled. 

Octal Correction Meaning 


octal correction The correction replaces the contents of the 

memory location determined by the location 
field on the card and the position of this octal 
correction field on the card. 

blank or Do not alter the location 

contigous commas 


8-13 



octal correction Replaces the contents of memory determined by 
relocation factor the location stated on the card and the position 
of this field on the card. The address portion 
of the octal correction is to be positvely relo¬ 
cated as dictated by the reloeation factor. 


octal correction The same as above except relocation is 
minus sign decremental 

relocation factor 


octal correction The same as above except 17-bit arithmetic is 

relocation factor applied to the address. C must follow all octal 

C corrections containing character addresses to 

be relocated. 


octal correction Decremental character relocation, 
minus sign relo¬ 
cation factor C 


Relocation Factor 


Meaning 


no relocation factor Octal correction is to be stored as an absolute 
correction. 


(Subprogram name) Relocate the word address portion of the octal 
correction relative to the address of the first 
location in the subprogram named within the 
parenthesis. 

D Relocate the word address portion of the octal 

correction relative to the DATA area assigned 
for this run. 

C Relocate the word address portion of the octal 

correction relative to the COMMON area 
assigned for this run. 

X A program extension area has been assigned for 

this run and the word address portion of the octal 
correction must be relocated relative to the 
extension area. 

* Relocate the word address portion of the octal 

correction relative to the last subprogram named 
in any field of any preceding OCC or SNAP 
statements. 

relocation factor If C follows any relocation factor, perform char- 

C acter address arithmetic (17 bits). 
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SNAP 


SCOPE provides selective memory dmnps during execution. 


After a program has been loaded and before the RUN statement is encountered, 
the programmer may provide SNAP dump parameters on SNAP cards. The 
SNAPSHOT routine must have been loaded. This is accomplished by naming 
SNAPSHOT on an EXS loader control card. (See the loader section.) The 
SNAP statement provides parameters defining the instruction where the dump 
is to be taken, the area of memory to be dumped, and the dump format. 

Addresses for the SNAP statement have the same general format as the OCC 
statement. OCC statements and SNAP statements are processed after loading 
and prior to the RUN statement. Conflicts between OCC statements and SNAP 
statements cannot occur if all SNAP statements are placed behind all OCC 
statements. This matter is discussed in greater detail in the section on debug¬ 
ging. 

SNAP calling sequences are prepared from the SNAP statement. Each SNAP 
calling sequence consumes 7 locations in available memory. 

An error in a SNAP statement causes the statement to be ignored. Execution 
is never inhibited as the result of an error in a SNAP statement. The format 
is described below. 

7 

gSNAP, location, beginning address, ending address, mode, 
identification, comments 

or 

7 

SNAP, k , b, e, m, id 
y c 

Each parameter in a SNAP statement is separated by commas. Program names 
are always enclosed by parentheses in a SNAP statement. 

The SNAP statement defines a location containing an instruction which will be 
replaced by a jump to a SNAPSHOT calling sequence. Additional parameters 
define the beginning and ending addresses of the area to be dumped, the mode 
of the dumps, and a dump identification. After the dump has been taken, the 
instruction originally replaced is executed and control returns to the program 
at the succeeding location. 
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Entries in location fields of SNAP statements are listed below: 


Location Meaning 

<subprogram name>k Replace location k of the subprogram with a 

return jump to a calling sequence to be 
generated. 

Xk The jump to a SNAP calling sequence is to 

replace the instruction in location k of the 
program extension area defined for this run. 

Dk The jump to a SNAP calling sequence is to 

replace instruction k in the DATA area. 


The beginning address and ending address parameter are expressed in the 
same general manner. The ending address must always be greater than the 
starting address or the SNAP statement is ignored. 


Address 

Dk 

Ck 

Xk 


< subprogram name>k 


k* 


Meaning 

Dump begins or ends with location k in the 
DATA area. 

Dump begins or ends with location k in the 
COMMON area. 

Dump begins or ends with location k in the 
program extension area. 

Dump begins or ends with location k in the 
subprogram which had subprogram name in 
its IDC card. 

Dump begins or ends with location k of the 
subprogram last named in any field of any 
OCC or SNAP statement. 


The dump may be in one of three formats and may include the register 
file or not. 


Mode 

O 

C 

F 

R 


Identification 


Meaning 

Print dtimp in octal 

Print dump as 6-bit characters 

Print dump in floating point format 

Print register file in octal. R may be combined with 
any of the other options as OR, RC, etc. Refer to 
the section on debugging. 

Meaning 

Zero through four BCD characters will be printed on the 
SNAP output to identify the dump. 
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OPERATOR CONTROL OF SCOPE 9 


SCOPE yields control to the operator once per job as shown in the flow diagram 
Immediately after a SEQUENCE card has been read and processed, SCOPE 
interrogates the CFO for operator control staten>ents. These statements may 
consist of equipment changes or other manipulation of the I/O environment, the 
calling and execution of library programs, priority selection of a particular job 
for immediate processing, or termination of the SCOPE run. 

An operator may manually interrupt SCOPE during job processing. If the user 
has not selected a manual interrupt and the operator presses the manual inter¬ 
rupt button, the current job is terminated and control is given to the operator 
after SCOPE has positioned INP past the next SEQUENCE statement. 


OPERATOR 

CONTROL 

STATEMENTS The operator may issue control statements to SCOPE through CFO which is 

usually a console typewriter. These statements consist of the statement name 
followed by commas and parameters if required. The statement is terminated 
by pressing the CLEAR or FINISH buttons. When the operator t 3 q)es a period 
and presses CLEAR, SCOPE begins processing the next job. 


SEQUENCE SEQUENCE no parameters 

or 

SEQUENCE, j j is the sequence number of any job on INP. 

With the SEQUENCE statement, the operator selects a job to be processed. 
SCOPE interrogates CFO for statements after a SEQUENCE card has been read 
from INP and logged on CTO. The operator may control job sequencing as 
follows. 

To process the job with the sequence number printed on CTO, the operator types 
a period after issuing any other necessary statements, and return to SCOPE 
without using the SEQUENCE statement. 

To repeat the last job processed, the operator types SEQUENCE, last job 
sequence number. SCOPE will backspace INP, for magnetic tape, and repeat 
the last job. 
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ENDSCOPE 


REWIND AND 
UNLOAD 


AET 


The operator may select any job on INP for immediate processing using the 
statement; 

SEQUENCE, job sequence number. 

The operator may issue SEQUENCE with no parameter on CFO; the job whose 
sequence number v/as logged on CTO will be skipped; and INP will be positioned 
to the next SEQUENCE statement on INP. 

If the desired job is known to exist on INP in front of the job whose sequence 
number was last logged on CTO, and INP is magnetic tape, the operator may 
use the REWIND statement to rewind INP, 60, before issuing the SEQUENCE 
statement. 


ENDSCOPE 

The operator terminates the SCOPE run with this statement. The action taken 
.by SCOPE is identical to that for the programmer control statement ENDSCOPE. 


REWIND 

UNLOAD’^1’^2.%■ 

As many logical units, u., may be expressed as required. These statements 
for control of magnetic tape cause SCOPE to take the same action as described 
for the programmer control statements, REWIND and UNLOAD, The operator 
may refer to any logical unit, 1-63, without restriction. 


The operator interrogates or alters the available equipment table using the 
AET operator control statement (Appendix). This statement has three forms: 

AET When the operator uses AET without commas or param¬ 

eters, the content of the entire table is printed on CTO 
in octal, 

AET, a 1 ^ a ^ When the a parameter is used, only entry 

a in the table is printed, t 

AET, a, P 1 < a 50 ^q, P may have two forms. This version of 

the AET statement alters entry a in the table as indicated by P. 


fThe length of the AET table, which may not be greater than 50 , is established 

by each installation. 
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P, UP set the s field, bit 17, in the AET word to operable. 

P, DOWN set the s field to inoperable. 

P, RES set the unit reserved for another computer. 

P, FREE clear the unit for use by this computer. 


P is an octal integer of 11 or 16 digits. Replace entry a in 

AET with the octal value. The octal digits are stored left 
justified into the AET entry. The driver address, the D 
field, may be specified by the octal integer or supplied 
by SCOPE or the LOADER. 


CALL CALL, library name, p , p , . . . p 

X ^ ri 

The first parameter, library name, must be the name of an entry point in file 
two of LIB. The following parameters are not used by SCOPE but are passed 
to the called program, pi, P 2 , P 3 , . . . , Pj^ vary according to the called pro¬ 
gram and the order and content are dictated by the library program. 

The operator may call programs from LIB for execution using the CALL state¬ 
ment. When the CALL statement is encoimtered, protection of system I/O is 
voided, the message " OPERATOR” is written on OUT and a blank card (or 
card image) is written on PUN if it is assigned. Recovery dumps are sup¬ 
pressed. The called program is then operated as any library run. SCOPE 
requests additional statements via CFO when the library program has been 
executed. 

The name used as a parameter in the CALL statement must be an entry point 
name defined in a program in file two of LIB. 


EQUIP The operator alters equipment assignments when SCOPE interrogates CFO for 

operator control statements. The operator uses the EQUIP, x = d statement in 
the same manner as does the programmer. The operator may reference any 
logical unit (1-63). The operators' designation of the EQUIP statement over¬ 
rides loader or system assignment of I/O on LIB. 

SCOPE informs the operator of the sequence of job processing, requests infor¬ 
mation and produces error messages on CTO. The operator is also advised of 
actions required for SCOPE to perform particular tasks. 


9-3 



AUTOLOAD 


After SCOPE has been autoloaded, the operator must supply information to 
initialize the system. After SCOPE types a message, the operator replies with 
the requested information or acknowledges the message by pressing the FINISH 
button. If the CFO is not the console typewriter, a blank record signals com¬ 
pleted action. 

Scope Message Operator Message 

DATE dd mm yy, press FINISH 

TIME hh cc, press FINISH 

OUT AET ordinal of OUT or INP, press FINISH. If the 

assignment for OUT or INP is not to be changed, 
it is only necessary to press FINISH. 

dd day 

mm month 

yy year 

hh hour, 00-24 ;j^q 
cc minutes, 00-60 ^q 

If date and time are not given, zero will be assigned by SCOPE. 


SEQUENCE PRINT SEQUENCE, decimal number. When a SEQUENCE card is encountered on INP 

it is logged on CTO. The TYPELOAD indicator will light. SCOPE waits for 
an operator control statement. 


PROGRESS 

REPORTS 


Messages appear on CTO to advise the operator about the job in process which 
do not require any action from the operator. These messages may enable the 
operator to perforin such tasks as reloading tapes, removing output from the 
printer or a job deck from the card reader. The following programmer control 
statements are logged. 

REWIND 

UNLOAD 

RUN 

CTO 

JOB, account number, name, time 

When the ENDSCOPE statement is detected on INP or CFO, SCOPE reports 
this function on CTO. 
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REPEAT MESSAGE 


READY MESSAGE 


END CALL 
MESSAGE 


NON-STACKED JOB 
TERMINATION 


REPORT ON 
EQUIPMENT 
ASSIGNMENT 


When SCOPE encounters a CTO, comment to operator, statement on INP the 
statement is logged on CTO. 


SCOPE will request the operator to repeat any message which it cannot decipher; 
the message is assumed to be in error. SCOPE will log REPEAT on CTO. 


After the unit assignments are logged, SCOPE outputs: READY? on CTO and 
waits for the operator to complete any required action. The operator responds 
when ready to process the job by pressing FINISH. 


When a library program is called via the operator CALL statement, the success¬ 
ful operation of the called program is reported on CTO as: END CALL. 

Abnormal termination of the called program produces the message: ABNORMAL 
END CALL. The operator may issue additional control statements on 
CFO. 


When SCOPE has completed processing a non-stacked job, the operator is 
notified by one of two messages on CTO. 

NORMAL END run was successful 

ABNORMAL END run was unsuccessful 

The operator must reload the system units and follow the autoload procedure 
to continue. 


SCOPE will log equipment assignments on CTO 

ijg = HW Cc Ee Uuu 
ii = logical unit number 
HW = hardware type 
c = channel 
e = equipment 
uu s= unit 
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I/O UNIT 
NOT READY 


FAULTY I/O 
ASSIGNMENT 


DATA 

TRANSMISSION 

FAULT 


PROTECTED TAPE 


END OF TAPE 


If an assigned input/output unit is not ready when SCOPE requires it, this 
message is printed on CTO: 

READY LUN logjical unit number 

SCOPE awaits operator action on the unit. When ready to proceed, the operator 
presses FINISH. 


If SCOPE cannot execute an input/output requirement, this message will be 
logged on CTO and the computer halts. 

CANNOT DRIVE] logical unit num^ber 

The operator checks the physical unit to which the logical unit is assigned for 
operability and appropriate assignment, (i. e., INP is not the line printer if 60 
were involved). To restart the computer the operator must press GO, 


When control cards are read from INP, parity errors produce this message 
on CTO. 

INP ERR 

SCOPE logs this for operator information, and accepts the information. 


If a file-protecteo anagnetic tape is designated for output, the computer awaits 
operator action after SCOPE has output a ssage on CTO. 

ENABLE WPiITE logical unit number 

The operator must load a new tape or put the write ring in place, and then 
press E’INISH. 


If end of tape is reached on a logical unit, SCOPE reports: 

LOAD NEW logical unit number 

The computer waits for operator action. When the operator has loaded the new 
tape, he may continue by pressing FINISH. 
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INPUT/OUTPUT 

ERROR 


AET ERROR 


If an input/output unit fails during operation, SCOPE prints a message on CTO: 
I/O ERR error code LUN logical unit number 


Error Codes, 2 characters 


character 1 


character 2 


C connect P parity error during I/O instruction transfer 

S select I internal reject 

E external reject 

Q undefined condition caused reject 
UU undefined logical unit reference attempted 
2 digits ~ protected unit violation 


01 

02 

03 

04 

05 

06 

07 

08 

09 

10 


undefined unit 

hardware reject of connect code not used 
not used 

protected function on LIB unit 

protected function on PUN or OUT 

protected function on INP 

protected function on CTO 

protected function on CFO 

EOF detected and protected function on INP 

hardware reject of WE OF or Unload on PUN 
or OUT after an EOT was detected 


If illegal entries are discovered in the AET table, the message AET ERR is 
logged on CTO and the computer halts. The error may be due to conflicting 
entries in AET or a program or hardware malfunction. The operator may 
initiate a simulated autoload of SCOPE by pressing GO. If the error indication 
persists, the operator should refer the problem to the system programmer who 
maintains LIB or the customer engineer. 
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ORGANIZATION OF MEMORY 


10 


AVAILABLE 

MEMORY 

ORGANIZATION 


The computer memory is organized by SCOPE into system memory and avail¬ 
able memory. System memory contains those portions of SCOPE and input/out- 
put routines required for SCOPE during a job. This includes resident, which 
is always in memory, and routines selected by options such as system unit pro¬ 
tection, recovery dump, and CIO routines for non-standard system I/O units. 
Resident occupies low memory and the other SCOPE I/O drivers reside in high 
memory. 


Available memory is organized by the loader from parameters received from 
resident. The contents of memory during SCOPE and loader operation are sig¬ 
nificant to the programmer only because the area used by SCOPE and loader is 
the area used for common storage; consequently, information may not be pre¬ 
stored in common during loading. 

Available memory may be used by a program to be loaded and executed under 
SCOPE supervision. It may be a library program such as COMPASS, 

FORTRAN, COBOL, ALGOL, SORT or PRELIB; or it may be a group of sub¬ 
programs for a programmer run. 

Available memory is divided into three areas which must be considered when 
coding programs in the source language and preparing binary subprograms for 
input by loader. A fourth area, the program extension area, is defined if octal 
corrections add instructions to a subprogram. The four areas which must be 
considered are: 

Subprogram area 

Data area 

Common area 

Program Extension area 

The assignments for these areas are identified on a memory MAP which may be 
printed following loading. During loading, assignment and allocation of space to 
these areas is dynamic. The system performs the assignment using parameters, 
contained in the program decks, which were derived during assembly or com¬ 
pilation. SNAP statements consume available memory but do not appear on 
MAP. Program overlays are assigned to memory according to requirements 
discussed in the section on overlays. 
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SUBPROGRAM 


DATA AREA 


AREA The subprogram area for a run is defined by parameters obtained from the IDC 
cards from all of the subprograms loaded for the run. The total subprogram 
area is equal to the sum of all the subprogram lengths specified on all of the IDC 
cards encountered during loading for the run. 


The data area is defined once per run by parameters obtained from the first IDC 
card encountered with a non zero length for a data area. The data area, when 
defined, is shared by all subprograms. The data area is outside the first sub¬ 
program which declares it; but if more than one subprogram is loaded , it is 
bounded by the subprogram area. 


Available Memory 


System I/O 


Subprogram 1 


DATA Area 


Subprogram 2 


Subprogram 3 


COMMON 


RESIDENT 




Subprogram Area 


Since the data area is defined only once per run, the first subprogram loaded 
must reserve sufficient space to accommodate any data area used by any sub¬ 
programs loaded for the run. 

Generally, information v/ill be stored into the data area by the loader. The 
absolute starting address of the data area is the same for all subprograms 
during the run. Therefore, in assembling instructions or constants for storage 
into the data area during loading, the programmer must consider all subpro¬ 
grams to be loaded. The programmer must guarantee the proper placement of 
information in the data area in the source subprogram. This may be accom¬ 
plished in COMPASS through the pseudo instructions ORGR and BSS. Library 
routines may reference the same data area as all other programs. The pro¬ 
grammer must consider this when defining and using the data area in the source 
subprogram. 
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For example, two subprograms, BAKER and GEORGE are to be loaded and 
executed at the same time. Program BAKER is loaded first. If program 
BAKER uses lOOg locations in the data area and GEORGE uses 50g locations, 
the structure of the source programs might be: 

IDENT BAKER 

DATA or 

BSS 150B 
ORGR 0 

PRG 

END 

IDENT GEORGE 

DATA 

BSS 150B or 

ORGR lOOB 

PRG 

END 

The DATA area length declared in the IDC card of subprogram BAKER includes 
the area required by GEORGE. 

The DATA area may also be organized as follows: 

ABLE 

20, this is the ABLE buffer 

20 space reserved for BAKER 

20 space reserved for CHAS 


IDENT 

DATA 

BUFA BCD 

BSS 
BSS 
PRG 

END 


DATA 

lOOg locations of data 

BSS 50B 
PRG 

DATA 
ORGR lOOB 

50 locations of data 

PRG 
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IDENT 

BAKER 



DATA 



or ORG 20 

BSS 

20 

space reserved for ABLE 

BUFB 

BCD 

20, 

this is the BAKER buffer 


BSS 

20 

space reserved for CHAS 


PRG 




END 




mENT 

CHAS 



DATA 




BSS 

20 

space reserved for ABLE 

or ORG 20 




BSS 

20 

space reserved for BAKER 

BUFC 

BCD 

20, 

this is the CHAS buffer 


PRG 




ENID 




COMMON AREA The common area is shared by all subprograms. Each time an IDC card is 

encountered, the lengtli of the common area is examined. If the presently 
defined area has fewer locations than declared on the current IDC card, the 
length of common is ex-tended to include the subprogram. The final length 
defined for common, will be the greatest length declared on the IDC card of any 
subprogram loaded for the run. 

Common has the same absolute starting address throughout the run. The pro¬ 
grammer must guai^antee the integrity of information in common during program 
execution to insure that information needed by one subprogram is not destroyed 
by another. 

The area of available memory destined to be the common area during a run is 
occupied by the loader and loader symbol table prior to execution; information 
cannot be stored in the common area during loading. Compilers and assemblers 
for Control Data computers will not allow the production of object subprograms 
which would prestore common. 


PROGRAM EXTENSION The program extension area is defined by SCOPE from programmer OCC state¬ 
ments processed after loading. It follows the subprogram area. Rules pertain¬ 
ing to program extension areas are described in the section on debugging. 
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ASSIGNMENT 
OF AVAILABLE 
MEMORY 


RELOCATABILITY 


During loading, memory is allocated to the subprogram area, the data area, 
and the common area. Initially, all of non-system memory is available. 


System I/O 


AVAILABLE 


Variable Resident 


RESIDENT 


When the first IDC card is encountered, the subprogram and common areas are 
assigned for that subprogram and the data area if of non-zero length is assigned 
for an entire run. 

When the second subprogram is loaded into memory, the definition of a larger 
common will extend the length of common, but the data area will remain 
unchanged regardless of the length declared after the data area is defined. An 
error message will result if the data area declared in the card cannot be con¬ 
tained in the area defined for the run. 


Addresses assigned by the compilers and assemblers are called relocatable; 
they do not identify actual addresses in the computer memory. They may be 
considered as sequence numbers or reference points. Relocatable addresses 
are relative to the beginning of the subprogram. 

During coding in symbolic language the programmer has little interest in the 
ultimate assignment of absolute memory locations for use by his program. He 
organizes the program and dictates certain relationships between instructions 
and data. The compilers and assemblers record the relationships and produce 
relocatable object subprograms. 

In a relocatable subprogram, the first location is given a sequence number or 
starting location of zero. Each successive instruction or data word in the sub¬ 
program is assigned an address one greater than its predecessor. By applying 
the same increment or decrement to these relocatable addresses or sequence 
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77777 

37777 

17777 


00000 


System I/O 

77777 

System I/O 

Subprogram 1 


Subprogram 1 

DATA 

Area for run 


DATA 

Area for run 



Subprogram 2 

AVAILABLE 


AVAILABLE 




COMMON 


COMMON 

Variable Resident 


Variable Resident 

RESIDENT 

00000 

RESIDENT 


numbers, they may be assigned to any memory location desired during loading. 
It is important to retain the relationships established (or detected) during 
assembly or compilation. 

By treating subprograms as unified blocks, and maintaining a constant interval 
between the internal parts, it is possible to leave the ultimate assignment of 
memory to the loader. Entry points and external symbols allow the loader to 
establish the correct linkage between subprograms. 
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RELOCATION OF 
SUBPROGRAMS 


RELOCATION 

BYTES 


Data and common storage are treated in a manner similar to the subprogram 
storage. The first location assumed by the assemblers and compilers is zero 
and the areas are addressed relatively thereafter. The loader relocates the 
addresses; the assemblers and compilers provide a separate relocation factor 
for each object program area. 


Assembler and compiler will determine which relocation factor is to be applied 
during loading. The loader determines which relocation factors to use by word 
count, or for RIF cards, by a relocation byte. 

subprogram increment 
common area increment 
data area increment 
subprogram decrement 
common area decrement 
data area decrement 

X, extension area increment (specified by programmer) 


The relocation byte determines whether the address in the word on the card is 
to be incremented or decremented, which area is involved, and whether to per¬ 
form 15-bit or 17-bit arithmetic on the address. 
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RELOCATION 
BYTE OPTION 


The relocation byte consists of 4 bits. 


relocation byte 


0 

or 1 








_ i 


_word/character relocation factor designators 


indicator 

0 15-bit arithmetic 
1 17-bit arithmetic 

Relocation Byte Relocation Factor 

xOOO not used; this code constitutes an error 

xOOl no relocation (absolute) 

xOlO subprogram increment 

xOll common block increment 

xlOO data block increment 

xlOl subprogram decrement 

xllO common block decrement 

xlll data block decrement 
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SCOPE BINARY SUBPROGRAM 


11 


SCOPE provides a modular loader for relocatable binary object subprograms 
assembled or compiled by COMPASS, FORTRAN, COBOL, ALGOL and certain 
elements of the BASIC software package. The loader also prepares overlays 
from relocatable binary subprogram decks. The loader is called by SCOPE 
when a library name statement, a LOAD statement or a loader card is encoun¬ 
tered on INP. 

For user programmers the loader provides the following services: 

Loads relocatable binary subprograms. 

Establishes communication and linkage between independently assembled 
and/or compiled subprograms. 

Loads and links library routines called by loaded subprograms. 

Loads I/O drivers required for program execution from information 
supplied by the programmer or operator and stored in system tables. 

Loads and links BCD and floating point simulator routines as required, 
without user action. 

Prepares error messages and diagnostics for errors detected in the 
loader input. 

Accumulates checksums for the binary information and compares this 
checksum against one in the binary cards to guarantee accurate loading 
of subprograms. 

When loader is placed in control, it accepts both loader control cards and binary 
subprogram decks as input. 

Both loader cards and loader control cards have 7, 9 punches and punches in 
rows 3-12 of column one. Rows 3-12 are called the word count field. The 
loader recognizes a card by the contents of this field. 


LOADER 

CONTROL CARDS Loader control cards provide specific information for the loader or direct the 

loader in processing the binary subprogram decks. Of the five loader control 
cards, three control preparation of overlay programs and two control linkage 
or input-output. Except for column one, which is binary, loader control cards 
contain symbolic information in 12-bit Hollerith. 
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LOADER CARDS 


OBJECT 

SUBPROGRAM 

STRUCTURE 


Name 

Function 

Octal Word Count 

MAIN 

main overlay program 

50 

OVERLAY 

overlay program element 

51 

SEGMENT 

overlay program segment 

52 

EXS 

external symbol declaration 

55 

LED 

loader equipment declaration 

54 


These cards may appear at any position in the loader input. Sequence is impor¬ 
tant only when the success of an operation depends on the prior appearance of 
the control card. For example, if overlays are to be processed, MAIN must be 
the first card in the loader input. 


Name 

Function 

Octal Word Count 

IDC 

subprogram identification card 

41 

EPT 

entry point name card 

42 

RIF 

relocatable information card 

1-40 

XNL 

external name card 

43 

LRL 

local reference list card 

45 

TRA 

transfer address card 

44 


To load subprograms, the loader must find an IDC card to obtain the length of 
subprograms, data and common areas for the subprogram. 

The first card in a subprogram deck must be an IDC card, the last, a TRA 
card. If several subprograms are loaded, the TRA card for one subprogram 
should be followed immediately by the IDC card of the succeeding subprogram; 
LED and EXS cards, however may intervene except in file two of LIB. Overlay 
control cards always precede an IDC card. 

Between the IDC and TRA card, any other loader cards may appear. The 
loader will accept these cards in any sequence but correct subprogram linl'cage 
and exccutability of the loaded program depends on a particular sequence within 
a subprogram. The descriptions of the loader cards, EPT, XNL, LRL, provide 
specific details. 
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TYPICAL LOADER 
INPUT STRUCTURE 


LOADING LIBRARY 
ROUTINES 


CHECKSUM IN 
BINARY DECKS 


A relocatable binary subprogram deck prepared by a compiler or assembler 
is in correct sequence for loading. If this sequence is disturbed, the following 
structure is reasonable for accurate loading; 

IDC card 

all EPT cards 

all RIF cards 

all LRL cards 

all XNL cards 

TRA card 

Should two subprogram decks become intermixed, the decks are useless and 
the subprograms should be reassembled or recompiled. 


After all programmer decks are loaded, the loader searches file two of LIB 
to match external symbols with entry point names. The search begins from 
the current position of LIB. The loader scans LIB until an IDC card is found; 
the EPT cards which follow are examined. If a desired entry point name is 
found, the routine is loaded. If a non EPT card is found before a desired entry 
point name is detected, the loader skips to the next IDC card on LIB before 
searching for another entry point name. 

Loading of library routines terminates when there are no undefined entry point 
names in the loader symbol table or when LIB has been rewound and searched 
to the end of file two without a routine being loaded. 


The loader cards contain a checksum. With the single exception of the TRA 
card, the checksimi pertains to all the information in the card except that in 
columns 3 and 4, the checksum field. The TRA card contains the checksum 
for all other loader cards encountered since the last IDC card except the TRA 
card. 

Checksum errors result when the loader derived checksum does not compare 
bit for bit with the checksum in the card. This discrepancy may be due either 
to failures in hardware or the checksum may be in error. If the data in the 
card is correct and the checksum is in error, ignore the checksum. 

If the ignore checksum field, row 8 of column 1, contains a punch, the checksum 
on the card is ignored, and no comparison is attempted. If the card is a TRA, 
the subprogram checksum is ignored. When any card originally produced in a 
subprogram deck has a punch in the ignore checksum field, the TRA card must 
have an ignore checksum punch as well. When a TRA card is inserted in a 
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subprogram deck to facilitate loading several subprograms for execution, the 
ignore checksum field should always be punched. 


LOADER CARD 
FORMAT 


The SCOPE loader accepts cards with punches in rows 7 and 9 of column 1 and 
certain specific punches in rows 12, 11, 0, 1, 2, 3 of column 1. 


The first four columns are the same for all loader cards. The first column 
identifies the card; the second provides an address or other information about 
storage; the third and fourth hold a checksum. 



Card 


Computer Word 


Mnemonic 

Column 

Rows 

Bit Position 

Purpose 

W 

1 

12, 11, 0, 
1,2,3 

23-18 


word count (not zero) 

B 

1 

7,9 

14 and 12 

binary card indication 

I 

1 

8 

13 


1 = 1, checksum ignored 
1 = 0, checksum must 






compare 

A 

1 

4,5,6 

17-15 


relocatable address. 


2 

12, 11, 0, 

11-0 


sequence number or 



1-9, 



program length 

C 

3 

12, 11, 0 
1-9 

23-12 ' 




4 

12, 11, 0, 

11-0 

► 

24-bit checksum 



1-9 

j 
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Two card columns of 12 bits each are contained in one 24-bit computer word. 
The content of row 12 of card column 1 is in bit 23 of the first computer word, 
row 9 of card column 1 is in bit 12, row 12 of card column 2 is in bit 11 of the 
first computer word and row 9 is in bit zero. If there is a punch in the card 
the corresponding bit position contains a one. 


column 1 


column 2 


column 3 


column 4 


Punch in 
Row: 


12 

11 

0 

1 


12 

11 

0 

1 


12 

11 

0 

1 


Corresponding 
Bit Position 


23 

22 

21 

20 


12 

11 

10 

9 

8 


23 

22 

21 

20 


12 



12 

11 


11 

10 


0 

9 


1 

8 


9 

0 


computer word 1 


computer word 2 
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IDC CARD 


Rows 


The subprogram identification card is a binary card which identifies and pro¬ 
vides information about the subprogram to the loader. The IDC card must be 
the first loader card in a subprogram deck. 

The IDC card has an arbitrary word count of 41g and states the name of the 
subprogram, its length, and the sizes of the common area and the data area 
in words. The first subprogram loaded which specifies a non-zero data area 
defines the data area for the entire run. It is important to structure the 
loader input so that the data area is properly defined to accommodate all sub¬ 
programs and information to be stored in the data area during loading and 
execution. 

An IDC card is produced by an assembler or compiler. The name in the card 
is taken from the program name in a source language statement such as the 
IDENT card in the COMPASS language. 


Card Computer 

Columns Words Meaning 


1-2 

1 

W = 41g, Subprogram length in words 

3-4 

2 

C = checksiim 

5-8 

3-4 

subprogram name in 6-bit BCDt 

9-10 

5 

common block length in words 

11-12 

6 

data block length in words 

13-80 

7-40 

unused 



fThe name is eight characters or less, left adjusted with trailing blanks added. 
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EPT CARD 


Entry points in subprograms are declared by source language statements such 
as ENTRY in COMPASS: EPT cards result in relocatable binary decks. EPT 
card has an arbitrary word count of 42 ; it contains one or more entry point 
names and the equivalent relocatable addresses. Names are in 6-bit internal 
BCD and may be 8 characters or less. If names are less than 8 characters, 
a record mark, character code 72g, follows the last character in the name. 
The name is followed by an 18-bit value; the rightmost 15 bits define the relo¬ 
catable word address assigned to the entry point within the subprogram which 
will be relocated using the subprogram increment. 

The A field contains a sequence number for programmer convenience; it is not 
used by the loader. An entry point name and its equivalent address must be 
wholly contained on a single card. 


Card Computer 

Columns Word Meaning 


1-2 

1 

W=42g. A = sequence number 1, 2, 3, 

3-4 

2 

C = checksum 

5-80 

7-40 

entry point names and locations 


The EPT card shown contains three entry point addresses, A1234567, BAKER 
and JACKSON. 



# = record mark 
b = blank 

shaded portion - relocatable address 
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RIF CARD 


Instructions and constants for storage in the subprogram and data areas are 
contained in relocatable binary information cards. The actual word count of an 
RIF card may vary from 1 to 40g depending on the number of instructions and 
constants in the card. The card is checksummed and has a relocatable load 
address which is always a 15-bit address. 

The first instruction or constant in the RIF card is stored at the location ref¬ 
erenced by the relocated word address. All other instructions and constants 
are stored in successive locations in memory. The load address may be in 
either the subprogpram or data area and may have a related relocation byte of 
OOIO 2 or OIOO 2 . The RIF card contains relocation*bytes for the load address 
and each instruction and constant in the card. 


Card 

Computer 


Column 

Word 

Meaning 

1-2 

1 

W = 1 to 408; A = load address of first 
word. 

3-4 

2 

C = checksum. 

5-16 

3-8 

up to 33 relocation bytes; the first applies 
to load address and may have values 


OOIO 2 or OIOO 2 . The other 32 relocation 
bytes apply to the address field of each 
machine word. Three bytes (12 bits) 
are unused. The first bit of each byte 
may be a 0 for a 15-bit address or 1 for 
a 17-bit address. The remaining three 
bits determine relocation 
factor. 

17-80 9-40 may contain up to 32 words of data or machine 

language instructions to be loaded after the 
relocation factor is applied to the address 
portion of each word. 
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RIF CARD 


XNL CARD 


WORD AND 
CHARACTER 



Subprogram communication is established by the loader using information 
from the external name and linkage card. The XNL card has an arbitrary 
word count of 483 and is checksummed. The card holds symbolic names of 
8 characters or less and a binary address related to the symbol. The symbol 
and address must be wholly contained on a single card. The symbolic name 
is that of an entry point in some other subprogram. The loader substitutes 
the address of the entry point whenever a reference is made in the subprogram 
to the external name. The XNL card results from source language statements 
such as the COMPASS pseudo instruction, EXT. The required entry point 
names may be in the permanent portion of the loader symbol table. They may 
be in EPT cards following the IDC card of a subprogram in file two of LIB, or 
they may be named in an EPT card of a subprogram loaded at the same time 
as the subprogram containing the XNL references. 

The XNL symbol need not be referenced by the subprogram in which it is 
declared. For example, the declaration of SNAPSHOT would not be referenced 
until after the subprogram has been loaded and SNAP statements encountered. 

If no reference occurs, the related address in the card is always 77777g. Any 
number of references with external symbols may occur in the subprogram. 

The compiler or assembler prepares a threaded list for the loader to use in 
establishing linkages. A symbol may be declared as external more than once 
in a single subprogram. The loader will link multiple declarations. 


EXTERNALS An external symbol may be referenced from a 15-bit word or 17-bit character 
address. A character address is denoted when the three leading bits of the 
relocatable binary address are non-zero. Only the most significant 15 bits of 
a character address are filled by the 15-bit entry point address. The two low 
order bits remain unchanged. 
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An XNL card has the same general format as an EPT card. 


LOCAL REFERENCE 
LIST CARD 


Card 

Computer 


C olumn 

Word 

Meaning 

1-2 

1 

W = 43g, A = sequence number 1, 
2, 3,... 

3-4 

2 

C = checksum 

5-80 

3-40 

External names and linkages 


The name is 8 characters or less, if it is less than 8 characters, a record 
mark follows. Immediately following name or record mark are 18 bits of 
which the rightmost 15 specify the location of the instruction referencing the 
external symbol. If ;any of the three leading bits are non-zero the reference is 
from a 17-bit address, or string of 17-bit addresses. If several instructions 
reference the external symbol, a string is formulated and the address on the 
card provides the location of the first entry in the string. The address in the 
XNL card is the relocatable word address of the first instruction in the sub¬ 
program which references the XNL name. The address field of that instruc¬ 
tion contains the relocatable address of the second instruction referencing 
the symbol, and so on, until the final reference. The address field of the last 
reference contains 77777g to terminate the string. 

If no reference is made by an instruction in the subprogram, the address on 
XNL card will contain 77777g. The number of XNL cards in a subprogram 
deck is not restricted. 

The sequence of XNL cards in a subprogram deck is important if multiple 
references occur. An XNL card should not be the first card in a deck. If 
the external name is declared only once in the subprogram, the XNL card 
may appear anywhere between the IDC and TRA cards. If the external name 
appears more than once, (on two or more XNL cards) the string related to 
the first reference must be loaded before the XNL card containing the next 
declaration is encountered by the loader. Strings must not be interrupted by 
multiple declarations. A simple solution is to place all XNL cards imme- - 
diately in front of the TRA card if the sequence established by the compiler 
or assembler has been disturbed. 


The local reference list card is produced by an assembler or compiler, when 
a reference is made in the source program to a symbolic address not yet 
defined. The compiler or assembler builds a string of addresses at which a 
reference is made to the undefined address. This string is identical in con¬ 
struction to that used for external names. The LRL card is produced when 
the symbolic address is defined. 
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The LRL card has an arbitrary word count of 453 and is checksummed. The 
LRL card must follow RIF cards containing the string. 

The LRL card contains the standard binary card information, a word/character 
flag, the relocatable subprogram address assigned to the local symbol which 
was initially undefined in the source program, the address of the first entry 
in the string and the length of the string list. 

All addresses in LRL cards are relocated using the subprogram relocation 
increment. 


LOCAL STRINGS 


The LRL card and its related string are similar to the external name cards 
and the strings associated with the XNL cards. Since LRL cards, the string, 
and the definition of the address are contained wholly within a single subpro¬ 
gram, no symbol need be used. The first address in the LRL card is local 
to the subprogram for which a definition is to be made. 

The first address is used similarly to the address in XNL cards following the 
the external names. This address is the relocatable address of the first loca¬ 
tion in the subprogram where a reference was made to the imdefined local 
address. The second address is the relocatable subprogram address assigned 
when the symbol was defined during assembly or compilation. 

The references to the second address constitute a threaded list or local refer¬ 
ence string. The string is terminated when the string length count in the card 
reaches zero or when the string contains an address of 77777g. If the zero 
length and the address of 77777g do not occur simultaneously, an error results 
and string processing is terminated. 


Card 

Column 

Computer 

Word 

Meaning 

1 

1 

standard binary card information, 
w = 45g 

2 

1 

word/character flag for address 
-0, word reference string 

0, character reference string 

3-4 

2 

24 bit checksum of LRL card 

5-6 

3 

address of the string of references 

7-8 

4 

relocatable subprogram address of 
first word of string in least signifi¬ 
cant 15 bits 

9-10 

5 

number of references to address in 
the subprogram (length of string) in 
least significant 15 bits 

11-80 

6-40 

not used 
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TRA CARD 


The final card in a subprogram deck is a transfer card. It contains the sub¬ 
program checksum, but the information in the TRA card is not checksummed. 
The TRA card has an arbitrary word count of 44g and may contain a transfer 
symbol. The TRA card is mandatory for successful operation. 

The transfer symbol designates the location of the first instruction to be exe¬ 
cuted under SCOPE, This starting address must be defined as an entry point. 

If the transfer symbol is defined as an entry point within the subprogram con¬ 
taining the TRA card, the assembler or compiler will punch the relocatable 
address in the A field of the TRA card. 

When loading more than one subprogram during a run, several TRA cards will 
be encountered and it is possible to have two or more TRA cards terminating 
a subprogram deck. However, if more than two transfer symbols occur, or 
if no TRA card contains a transfer symbol, a loader error results; the exe¬ 
cution of all subprograms loaded on the run is inhibited and the job is termi¬ 
nated. If execution of the program proceeds, SCOPE will pass control to the 
last transfer symbol encountered. 

When subprograms are loaded from file two of LIB, the first TRA card encoun¬ 
tered terminates loading of the subprogram. The loader will search LIB until 
an IDC card is found before loading can continue. 

The above pertains to program execution initiated by the RUN statement. Pro¬ 
grams called by the library program statement are initiated according to other 
rules. 


The TRA card, which must be the last in a subprogram deck, contains the 
standard binary information in column 1 and has a special checksum. The 
checksum in columns 3 and 4 is a checksum of all of the other binary card 
checksums in the subprogram. 

If the subprogram deck is changed by the addition, deletion or correction oT 
checksummed cards or if the TRA card is altered to supply or delete transfer 
symbols, the "ignore checksum field", I, bit 8 of column 1, must be punched 
for correct loading and execution. 
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Card Computer 

Columns Words Meaning 


1-2 1 


3-4 2 


5-12 3-6 


W = 44g. If TRA was produced by an 
assembler or compiler and the trans¬ 
fer symbol is defined within the sub¬ 
program, columns 1 and 2 contain the 
relocatable address assigned to the 
symbol. Otherwise, the A field is 
not used. Ignore checksum is fre¬ 
quently used. 

subprogram checksum, refer to 
text 

transfer symbol, 8 or less Hollerith 
characters terminated by a blank 


TRA Card 



The transfer symbol must appear in an EPT card loaded on the same run or 
appear in the permanent portion of the loader symbol tables. The transfer 
symbol is punched in Hollerith and may be punched on a keypunch. 


LOADER 

CONTROL 

CARDS 


Loader control cards provide information for the loader or direct the loader 
to perform special processing on the binary subprogram decks. Three of 
these cards control preparation of overlay programs and two control linkage 
and input/output. 


11-13 



Loader control cards are not checksummed and have an arbitrary word count 
of 5 O 3 or greater. Except for column 1, which is binary, loader control cards 
contain symbolic information in 12-bit Hollerith. Loader control cards may 
usually appear at any position in the loader input. The sequence is of impor¬ 
tance only when thcj success of some operation depends on the prior appearance 
of the control card. An example is the use of LED in preparing overlays. 

The equipment declarations are time dependent during such processing. 


EXS CONTROL CARD External symbols maj' be declared in binary subprogram decks after assembly 
or compilation using external symbol cards. It is used to declare external 
symbols not declared in the source language, or to alter the linking of external 
symbols to entry points. The EXS card could be used to include SNAPSHOT 
or another debugging routine in memory for a run, eliminating the necessity 
of a source language declaration and simplifying the transition between debug¬ 
ging and production runs. An EXS card might also be used to equate several 
external symbols to a single entry point to facilitate testing of sections of 
programs. 

EXS cards may appear in any position in the loader decks. On the LIB tape 
they may be placed only between the IDC and TEA cards for a subprogram. 

The EXS loader control card has an arbitrary word count of 55g. Except for 
column one, the card is free field. 

Card 

Column Meaning 


1 standard identification, 7/9 punches, W._= 55g 

2-8 two options; 

a. external symbol, external symbol, . .. , 
external symbol 

b. external symbol, 
external symbol, . . . , 
external symbol 

equal sign entry point name 


EXS PARAMETER 


When no equal sign appears, the external symbols are assumed to be entry 
point names in subprograms loaded for the run or entry point names of pro¬ 
grams contained in file two of LIB. The external symbols are processed as 
if they came from XNL cards which had no related linkage strings. A program 
executed under SCOPE does not normally have access to the linkage informa¬ 
tion obtained by this use of EXS cards. 
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When one or more external symbols are equated to a single entry point, 
loading the program in which the single entry point name is defined will 
satisfy all of the external symbol declarations. 

If an entry point name identical to an external symbol contained in such an 
EXS declaration appears after the EXS card, a duplicate symbol error will 
result. If the EXS declaration occurs during the loading process after the 
entry point name is defined, the normal relationship is overridden and the 
EXS declaration of equivalence prevails. However, the entry point name 
need not be defined prior to the EXS declaration. 


LED CONTROL CARD loader equipment declaration card assigns logical units to specific hard¬ 

ware units or to hardware of a particular type. If a logical unit named in a 
LED card has been previously assigned, the LED declaration is ignored. 
Units assigned by LED cards need not be declared on EQUIP cards. 

The LED card has an arbitrary word count of 54g. Except for column 1, 
the card is in 12-bit Hollerith and it is free field. Fields are separated by 
commas. Any number of LED cards may appear in any position of the loader 
input except on LIB, LED cards must occur between an IDC and the first 
TRA following. 

The LED card contains one or more hardware declarations. The last decla¬ 
ration must be wholly contained on the card. 

Card 

Columns Meaning 


1 standard loader information, 7/9 punches 

W = 54g 

Each declaration may have the form; 

LL hh or LL hh c e uu 

LL logical unit number 1 <LL< 56 

hh hardware type, as encoded in AET 

01 magnetic tape 
02 card reader 
03 printer 
04 card punch 
05 typewriter 
06 paper tape station 
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c 


channel number, 0 to 7 
equipment number, 0 to 7 
unit designator, two octal digits 


e 

uu 

Imbedded blanks are ignored. The declaration LL hh means assigns the logical 
unit to an available unit of the designated type. Other assignments are specific 
as to type, controller and device. The last declaration must be wholly con¬ 
tained on the card. 


LOADER ERRORS The loader audits and evaluates input. Any error will inhibit execution of the 

loaded program. When errors are detected a message is written on OUT. If 
possible the card in error is identified. The general types of errors reported 
are: 

checksum errors 
format errors 

symbolic address and linkage errors 

deck and subprogram sequence errors 

I/O errors due to faulty information, hardware failures 
or improper input formats 

The loader detects most errors but it is necessary for the programmer to 
protect previously loaded information from destruction by information from 
subsequent RIF cards. If two RIF cards in a single subprogram overlap in 
storage, the loader will give no indication. Normally this will not occur 
unless the original deck sequence established by the compiler or assembler 
is altered. 

It is also possible that information destined for storage in the data area from 
two subprograms could conflict so that information in one subprogram could 
be destroyed by information from subsequent subprograms. No error indi¬ 
cation is given. 


LOADER INPUT The first card in a loader input deck is an IDC card, unless the input is for 

overlay preparation. In this case, the first card encountered must be a 
MAIN card. The general structure of the subprogram deck is: 


IDC 

^^8 

EPT 

428 

RIF 

1-40, 

LRL 

458 
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XNL 43q 
TRA 44g 

If a MAIN card is encountered during overlay preparation, a card sequence 
error, CS, will result. If loader encounters a SEGMENT card before an 
OVERLAY card a card sequence error, CS, results, the card is processed 
as if it were OVERLAY and execution is inhibited. If MAIN was not the first 
card and MAIN, OVERLAY or SEGMENT appear in the loader input, a card 
sequence error occurs and the card is unrecognizable. 

The LRL card must appear after all RIF cards containing references to the 
string have been loaded. XNL cards need not occur in any particular sequence 
in the loader input unless the same symbol appears on more than one XNL 
card in the subprogram deck. 

If the sequence of a single subprogram deck has changes from that established 
by the system that produced it, the following sequence may be used; 

IDC 

EPT 

RIF 

XNL 

LRL 

TRA 

With the possible exception of RIF cards which are assigned to overlapping 
locations, this sequence will allow the subprogram to load correctly. 


LOADER ERROR 
MESSAGES 


If the message includes the character ^ , a character code which occupied 
the corresponding position in the card could not be converted. If a message 
includes the term t^UNCVRTt^, card columns 2 through 9 could not be con¬ 
verted to valid Hollerith information even though the word count indicates the 
card to be a loader control card. 

The loader maintains a count of errors detected. SCOPE prints the error 
count on OUT. Any error inhibits execution of the loaded program. 

If less than errors are detected, a true count is given. 


The loader diagnoses certain errors during loading and prints error messages 
on OUT. The format of the message may vary depending on the type of error 
and the card format. 
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If 64]0 errors are detected, loading is terminated, SCOPE prints a 63^0 
count and the job is terminated. 


LOADER ERROR 
CODES 


Error 


Word 


Code/Name 

Card Name 

Count 

Meaning 

CF 

TRA 

440 

Illegal character on card 

Card Format 

EXS 

548 



MAIN 

SOg 

Incorrect or illegal punches in 


OVERLAY 

518 

subfield 


SEGMENT 

00 

(M 

LO 


CS 


0 

Non-loader card has been read 

Card Sequence 



from a unit other than INP 


RIF 

1-408 

IDC card missing; no IDC card 


EPT 

428 

in front of loader cards follow¬ 


XNL 

438 

ing a TRA card 


LRL 

458 



TRA 

oc 

A zero length subprogram on 




LIB 


varies 


Unrecognizable binary card 


detected; card has non-zero 
word count; it may be an 
overlay control card if 
MAIN was not the first 
card in the deck 


IDC 

418 

IDC card detected which does 
not follow a TRA card. It is 
not the first IDC card in deck 

MAIN 

50 

Two MAIN cards in deck 

OVERLAY 

51 

a. Overlay control cards 

SEGMENT 

52 

internal to subprogram 


b. Overlay control cards 
are contiguous. No sub¬ 
program decks intervened. 

A zero length element has 
been specified. 

c. A SEGMENT card was not 
preceded by an OVERI^Y 
card. This SEGMENT 
card is treated as if it 
were OVERLAY. An error 

is counted to inhibit execution. 
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Error 


Word 


Code/Name 

Card Name 

Count 

Meaning 

CK 

any loader 


Checksum error detected in a 

Checksum 

Error 

card 


binary card 

DS 

EPT 

to 

00 

Entry point name appeared twice 

Duplicate 

Symbol 


during .loading 


UD 

XNL 

43o 

Declared name is not a defined 

Undefined 

TRA 

1 00 

entry point in a loaded subprogram, 


EXS 

548 

in file two of LIB, or in the perma¬ 
nent portion of loader symbol 
table 

TR 

TRA 

00 

a. No TRA card contained a 

Transfer 


transfer symbol 

Symbol 



b. More than two TRA cards 




contained transfer symbols 

RL 

RIF 

1-408 

a. Load address relocation 

Relocation 


byte is not OOIO 2 or OIOO 2 


Factor 

b. Load address relocation 
byte is OIOO 2 and data area 
is undefined 

c. Data area is part of overlay 
element already on tape 


d. Relocation byte is zero 


SE 

String 

Error 



Count in LRL card and actual 
references detected by loader 
do not agree 

SL 

String Loop 

XNL 

438 

String of addresses has resulted 
in a loop 

LX 

E qua ted 
Linkage 

Loop 

EXS 

543 

External symbol equated to 
another defines a loop 

MS 

Missing 

Subprogram 



Entry point name does not exist 
in file two of LIB to correspond 
to library name statement 

OV 

Memory 

Overflow 



This error always terminates 
loading 
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Error 

Code/Name 


EOF 

End of File 

EOT 
End of 
Tape 

I/O 

Input/output 

Error 


Word 

Card Name Count 


Meaning 


IDC 41 g Storage required for subprogram 

(common area or the data area, if 
this is first IDC) exceeds available 
memory 

OCC 00 During overlay processing, pro¬ 

gram extension area exceeds 
available memory 

Various Symbol printed in error message 

could not be entered in loader 
symbol table without infringing 
allocated memory 

Space in memory does not allow 
library search. Loading is 
terminated 


Loader encounters end-of-file 
on INP. Loading is terminated. 

During overlay preparation a 
physical end-of-tape is detected 
on output tape for writing. Over¬ 
lay processing is terminated 

a. After five attempts to read 
a magnetic tape, loader 
unable to read the logical 
unit, number of which is 
stated in the error message 

b. Error on input unit which 
was not magnetic tape 

c. Unit specified in an over¬ 
lay control card is not 
magnetic tape. Termi¬ 
nates loading and job 

d. An error occurred in 
writing a magnetic tape 
in overlay processing 
terminates loading and the 
job 
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ERROR MESSAGE 
FORMATS 

Binary Card Error 





PPPPPPPP 

CC 

WW 

AAAAA 




P - 

Subprogram Name 




c - 

Error Code 




w - 

Word Copnt 




A - 

Card Address Field 


Example; 





PROGRAM 1 

RL 

05 

06421 


Hollerith Card Error 




PPPPPPPP 

CC 

WW 

HHHHHHHH 




P - 

Subprogram Name 




C - 

Error Code 




w - 

Card Type 




H - 

Hollerith Columns 2-9 


Examples; 





PROGRAM 1 

cs 

66 

SPEC, 4, 2 


PROGRAM 1 

CF 

00 

T^UNCVRTt^ 


This message indicates columns 
2-9 of the card cannot be con¬ 
verted to valid Hollerith informa¬ 
tion 


Symbol Error 
PPPPPPPP 


Examples: 
PROGRAM 1 
PROGRAM 1 


CC SSSSSSSS 

P - Subprogram Name 
C - Error Code 
S - Symbol 


DS TAG4A 

CF TAGSMt^ 

If an unconvertible character is encountered 
in a Hollerith symbol, the CF diagnostic is 
printed with ^ in position of the bad character 
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Miscellaneous Errors 


pppppppp 

ccc 

XX 




p 

- Subprogram Name 



c 

- Error Code 



X 

- Other Number (if necessary) 

Examples; 




PROGRAM 1 

TR 

03 


PROGRAM 1 

I/O 

60 




OVERLAY PREPARATION 


12 


The SCOPE loader prepares overlay programs from relocatable binary sub¬ 
program decks. Overlays are composed of an executive or master control 
program called the main program and any number of parts called overlays 
and segments. 


OVERLAY 

PROCESSING Overlay processing allows programs that exceed available storage to be divided 

into independent parts which may be called and executed as needed. A program 
is divided into a main section and any number of overlays, each of which con¬ 
tains any number of segments. Main, overlay, and segment each contain sub¬ 
programs. Only main, one overlay, and one segment may occupy storage at 
a given time. 


The loader control cards, MAIN, OVERLAY, and SEGMENT, precede the 
relocatable binary subprograms which comprise the respective sections. 

After a source program is assembled or compiled, the decks are prepared 
and loaded. Each overlay or segment is written on an overlay tape as a sepa- 
atc record in absolute binary. The overlay tape is called in sections for exe¬ 
cution. The absolute records do not require the relocatable binary loader to 
perform the usual relocating and linlcing functions. 

If a segment is encoimtcrcd before any overlay is encountered, that segment 
is treated as an overlay. However, the Card Sequence Error message will 
display the segment identification number relevant to this segment. Refer 
to the section on loader errors. 

Initially, control is transferred to MAIN which resides in storage continu¬ 
ously; it in turn calls the overlays when they arc needed. Segments are called 
only by an overlay. FORTRAN and COMPASS subroutines, available to call 
the overlays and segments during execution, must be included in the MAIN 
clement. Once an overlay tape is created, it may be executed as many times 
as desired if the same equipment configuration and SCOPE resident programs 
are used with subsequent executions. Overlays occupy memory common to 
other overlays; segments associated with a given overlay occupy memory 
common to other segments of that overlay. 
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USE OF 
OVERLAYS 


OVERLAY TAPE 
FORMATS 


Segments may m:ake reference to only those addresses which are; 

1) defined within the segment 

2) defined in the overlay with which the segment is associated 
and from which it is called, and/or 

3) defined in the main program. 

Overlays may reference only those addresses defined within the overlay or 
the main program. 

The main program may refer only to addresses defined within itself. All 
entry point symbols referenced within the main program, an overlay, or a 
segment are defined for that program element and any elements subordinate 
to it. 

Overlays and segments are stored on tapes from which they are called to be 
executed. The tapes are prepared by the loader as specified by loader control 
cards. 

Two transfer addresses arc recorded for each element loaded. If a transfer 
address does not appear, or if more than two are encountered, an error is 
indicated. The transfer addresses for the main program are returned to the 
calling program. 

When the end of the program deck is reached, SCOPE reads the main program 
back into memory if it was stored on tape, prior to entering the user’s program. 

If an element written on tape contains the DATA block, the DATA block will 
retain its definition and may be referenced. The DATA block may not be 
loaded by subsequent elements subordinate to the element in which the DATA 
block was first defined. 


Overlay tapes contain program overlays and/or segments as prepared by tlie 
loader. Each overlay or segment is preeeded by a four word record which 
identifies the information record following. Information is recorded and read 
in binary mode with density unspecified. 

The identifying record format is: 


Word 

Word 

Word 

Word 
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primary (last encountered) transfer address 


OVERLAY AND 

SEGMENT 

EXECUTION 


secondary transfer address 

O nxunber from 001-143g, identifying an overlay 

S number from 001-143g, identifying a segment of the 

overlay identified by t 

FWA first word address into which the information record 
is to be read 

L length of information record in words 

Oand S are both 000 if the following record is the main program. 

The information record consists of absolute binary words which are read into 
FWA through FWA + L - 1. The last information record on each overlay tape 
is followed by an end-of-file. 


Overlays and segments are called from tape by entering a library routine from 
the main program. The routine is called by: 

place parameter in A 
RTJ EXECOVK 

EXECOVR is declared to be external to the main program. The parameters 
in A are given in the format: 


L 

23 18 14 76 0 

L logical unit number used to address the tape on 
which the overlay or segment is stored. 

I identifying number of the overlay or segment to be 
entered. I is in the range of 001-143g; bits 7-14 
are always zero. 

EXECOVR locates the segment or overlay on the indicated tape, reads it into 
memory, and passes control to it by executing an RTJ to its primary transfer 
address, with the secondary transfer address contained inA]^ 4 _ 0 . The segment 
or overlay returns control through the linJeage established. When return is 


t If the record is an overlay record, S contains 000. 
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made from a segment, EXECOVR returns control to the overlay which last 
called EXECOVR; if an overlay returns control, EXECOVR returns to the 
main program. The linkage to the main program, and the number of the over¬ 
lay to be entered is saved by EXECOVR each time an overlay is requested. 
EXECOVR may not be called within a segment; a call made to EXECOVR with¬ 
in an overlay causes loading of a segment; a call made from the main program 
causes loading of an overlay. 

If the requested overlay or segment cannot be located on the specified tape, 
or be read free of errors, the job is terminated. 

EXECOVR must be declared as an external symbol in the main program and 
in each overlay which calls it. EXECOVR is loaded from the library tape as 
part of the main program. 


MAPPING OF 
OVERLAY AND 
SEGMENTS 


The first word address of all subprograms comprising the overlay 
or segment. 

All entry points defined within the overlay or segment. 

The overlay or segment extension area, if one is assigned to 
contain corrections added to the overlay or segment. 

The load map for each overlay and segment is printed on a new page. 
The first line of each page is headed with the following line: 

” OVLAY nn SEG ss TAPER 

nn Overlay identification number (decimal) of this overlay, 

or of last preceding overlay if this is the map of a segment. 

ss Segment identification number (decimal) of this segment, 
or 00 if this is the map of an overlay. 

tt Logical tape unit number (decimal) of the tape unit on which 

this element was written. Illegal unit designations will produce 
a Card Format Error message. The parameter tt will then 
appear as 00. 

Similarly, illegal values of nn or ss will produce an error 
message, and the heading line of the corresponding map 
will show the illegal value as 00 for ss or nn. 


When an overlay or a segment has been prepared, a map of the memory is 
produced on the Standard Output unit, unless suppression is indicated by an 
S in the third field on the OVERLAY or SEGMENT card. The map shows; 
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OVERLAY 

CONTROL 


MAIN 


OVERLAY 


CARDS programmer prepares the loader control cards, MAIN, OVERLAY, and 
SEGMENT and places them in front of the subprogram decks. Corrections 
may be entered by OCC statements within the overlay input. 


MAIN must be the first card encountered by the loader when overlays are pre¬ 
pared. The subprograms following MAIN and preceding any other overlay 
control card constitute the main program. The MAIN card has an arbitrary 
word count of 50g and except for column one, the card is in 12-bit Hollerith. 
The MAIN card consists of the standard column 1 information and two fields 
of Hollerith information. 

Card Column Meaning 


1 standard identification, 7/9 punches, 

W = 50g 

2 beginning of two fields described below 

6-80 not used 

The first field begins in column 2 and is terminated by a blank or a comma. 
This field contains the logical unit number I-SSj^q of the magnetic tape on 
which an overlay program is to be written. If the MAIN program is not to be 
written on tape, field one may contain zero, two zeros, blank or a comma in 
column two. 

The second field contains a P if OCC cards are contained in the overlay deck. 
If OCC occurs and P is not declared, OCC cards will be treated as card 
sequence errors, code CS. 


The OVERLAY card precedes each intermediate element of overlay programs. 
All subprograms which follow, and precede another overlay control card (or to 
the end of the deck) constitute the OVERLAY. The OVERLAY card has an arbi¬ 
trary word count of 51g and is not checksummed. 

The OVERLAY card defines the overlay, the logical unit on which the overlay 
is written and determines whether a map of the overlay will be prepared. 

Card Column Meaning 


1 standard identification, 7/9 punches, 
W = 51g 

2 start of three fields 
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SEGMENT 


Three Hollerith fields separated by commas appear on the card beginning in 
column two. The first field specifies a logical unit niimber 1 to 55, on which 
the overlay will be v/ritten. This unit designation is mandatory. The second 
field contains a number, I to 99, which identifies the OVERLAY. The third 
field contains an S if the map for this overlay is to be suppressed. 


Overlay elements subordinate to OVERLAY are defined by SEGMENT cards. 

An OVERLAY may contain several segments. The subprograms following, to 
the next SEGMENT or OVERLAY card or the end of the program deck constitute 
a segment. Segments are subordinate to the overlay they follow. 

The SEGMENT card has an arbitrary word count of 52g and is not checksummed. 
The SEGMENT card determines the logical unit on which the segment will be 
written, the segment identification and whether a map of the segment will be 
prepared. 


Card Column 


Meaning 


1 standard identification, 7/9 punches, 

W = 52g 

2 start of three fields 

The SEGMENT card contains three Hollerith fields separated by commas. 

The first field contains the logical unit number, 1 to 55, on which the SEGMENT 
is written. This field is mandatory. The second field contains a SEGMENT 
identification number 1 to 99. The third field contains an S if the map of the 
segment is to be suppressed. 
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PROGRAM DEBUGGING 


13 


Debugging aids may be used at the source language or object levels. SCOPE 
will produce a map at the programmer's option to show the assignment of sub¬ 
programs, data, common, and the program extension area to memory. All 
entry point names and the assigned addresses are shown on the map as well. 

An octal correction routine allows changing, modifying or correcting the pro¬ 
gram after it has been loaded. Selective dumps may be obtained by means of 
the SNAP control statement. 


DUMP ROUTINES The programmer may choose several options for printing the contents of con¬ 
sole registers, the register file and part or all of the non-system memory. 
After programs have been loaded, the programmer may use the SCOPE control 
statement, SNAP, which will allow the printing of selected portions of memory 
during program execution. Calling sequences are available to specify a similar 
dump in the source language. Recovery dumps are also available should a pro¬ 
gram be terminated due to errors. 


MEMORY 

ALLOCATION 

PRINT 


The programmer may secure a map of memory allocated to a loaded program 
at the time the RUN statement is encountered. This map may be suppressed by 
a parameter of the RUN statement. 


The map contains: 

Heading Category 

SUBP the name of each subprogram as stated in the IDC card and 

the absolute address of the first location of the subprogram 
in execution time memory. 

ENTR the entry point symbol as taken from EPT cards and the abso¬ 

lute address of each entry point declared in any subprogram 
loaded for the run. 


COMM the absolute addresses of the first and last locations in the 

common area. 
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SYSTEM DUMP 
ROUTINE 


Heading (Category 

DATA the absolute address of the first location in the data area. 

PEXT the absolute address of the first location in the program 

extension area. 

Memory allocated to SNAP calling sequences is not included in the above areas 
and does not appear in the memory map. 

Items in the map for subprograms are ordered from the lowest numbered 
address to the highest numbered address. Each item in these categories 
appears in the below format, where XXXXX represents a 5-digit octal word 
address: XXXXX 8 character name 

The format for the data block and the extension area is: 

Identifier 

XXXXX 

The format for the common block is: 

COMM 

XXXXX x:^x5cx 

Each MAP begins a new page of print. Categories are separated by one blank 
line. No lines are skipped within categories. 

The information for the map is obtained from the loader symbol table. 


The programmer may use a dump routine to print the console registers, the 
register file and selected portions of non-system memory during a programmer 
run. The dump may be obtained in octal, character or decimal floating point 
formats. With the SNAP statement, the programmer may request the dump 
after the program has been loaded or may specify the dump in the FORTRAN 
or COMPASS source languages. 

Each time it is called, the dump routine prints, on OUT, one line containing 
the dump identification of 4 BCD characters, the address of the calling 
sequence, the contents of the A and Q registers, the three index registers and 
the interrupt mask register. Except for the dump identification all of the above 
is printed in octal. 

If the register file option is elected, the contents of all 64 registers are printed 
in octal following the console scoop. 
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SOURCE LANGUAGE 
CALLS FOR 
SYSTEM DUMP 


CALLING SYSTEM 
DUMP ROUTINE 


The memory dump consists of printed lines in the mode indicated in the calling 
sequence. This is preceded by the octal absolute address of the location. If 
all words in a line are identical to the last word printed on the preceding line, 
lines are suppressed until one is found in which a difference occurs. 

If the SNAP option is used, the dump routine prints the relocatable address of 
the location in the subprogram to the left of the absolute address of each print 
line. These columns are blank if the dump was not called by SNAP statements. 


The calling sequence for the system dump routine in either FORTRAN or 
COMPASS is incorporated into the object subprogram. Each time the sub¬ 
program is operated, the dump routine will be in memory and dumps will be 
taken. 

Except for relative address control, the format of the dump is the same for 
source time calls as for SNAP. The source language calls are shown below. 


The system dump routine has three entry points: FORTDUMP, called in 
FORTRAN programs; PROGDUMP, called in COMPASS programs; and SNAP¬ 
SHOT, called by the SCOPE control statement, SNAP. 

Source Calling Machine Language 

Statement Calling Sequence 


SCOPE Control Statement SNAPSHOT Calling Sequence 


g SNAP, LC, B, E,M,ID 


FWA 

m LWA 

Identification 


SRF 

^Snapped Instruction 


UJP 

RLA 

RTJ 

SNAPSHOT 
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COMPASS Statement 
RTJ PROGDUMP 
M ID B E 


FORTRAN Statement 

CALL FORTDUMP 
(B,E,M,ID) 


PROGDUMP Calling Sequence 


RTJ PROGDUMP 

FWA 

m LWA 

BCD 1, <4 char, iden- 

ification > 


FORTDUMP 

RTJ 

77 

77 

77 

77 


Calling Sequence 
FORTDUMP 
**L(FWA) 
**L(LWA) 
**L(MODE) 
**L(ID) 


* 


Terms in SCOPE Calling Statements: 

LC specifies the location of the instruction at which the SNAP 

occurs 

B beginning address of the dumped region 

E ending address of the dumped region 

M mode indicator 

ID identifier 
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Terms in Machine Language Calling Sequences: 


ERROR 

MNEMONICS 


FWA 

first word address to be dumped 

LWA 

last word address to be dumped 

RLA 

return linkage address to the program 

SRF 

subprogram relocation factor 

Mode or M 

mode indicator 

ID 

identification 

* 

indicates where control is returned 

**L(x) 

indicates the location of the word containing x 


Mnemonic 

Meaning 

For SNAP and OCC statements 

*PN 

Program Name 

*BS 

Common or data storage is 
undefined and referenced 

*AD 

Address or location field begins with 
illegal character 

*8F 

Octal field contains non-octal character 

*XA 

Extension area undefined or to small 

*WR 

Wraparound of location field address: 
exceeds core size 

For OCC statements only 

*AN 

Antecedent reference to a program (*) 
or loading address (+) 

*RL 

Relocation portion of correction field 
contains illegal character 


13-5 



Mnemonic 


Meaning 


SNAP 


For SNAP statements only 



*OV 

Overflow of memory will occur if this 
SNAP is loaded 

*IM 


Illegal Mode field on SNAP card 

*RG 


Range of area to be snapped has begin¬ 
ning address larger than ending address 


The format of the SNAP control statement is shown in the section on SCOPE 
control statements. SCOPE processes the SNAP statement and builds a calling 
sequence. The instruction at the designated location in the subprogram is 
exchanged for a jump to the calling sequence and saved for execution after the 
dump is taken. SNAP prints the dump on OUT as indicated by the parameters. 
The system dump routine must be loaded by the use of the loader control card 
EXS unless called by some source language option. 

The location at which the SNAP occurs must not be altered during execution or 
by OCC statements. V/hen SNAP and OCC statements are intermixed, an OCC 
statement must not destroy the jump to the SNAP calling sequence. 

In choosing instructions at which to request SNAP dumps, the programmer must 
follow certain rules. 

1. Do not SNAP at instructions involving more than one word, such as search, 
move, skips and certain I/O instructions. 

2. Do not SNAP conditional tests or jumps. 

3. Do not SNAP indirectly addressed instructions. 

4. Do not SNAP instructions which will be modified by program execution. 

5. Do not exchange any of the following instructions with a jump to the SNAP 
calling sequence. 
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Octal 

Mnemonic 

Octal 

Mnemonic 

10 

ISI 

07 

MTH 

10 

ISD 

10 

SSH 

04 

ASE 

52 

CPR 

04 

QSE 

77.0 

CON 

04 

ISE 

77.1 

SEL 

05 

ASG 

77.2 

EXS 

05 

QSG 

77.3 

INS 

05 

ISG 

77.4 

INTS 

06 

MEQ 

77.6 

PADS 

6. Do not exchange any instruction within the range of the following instruc 

tions with a jump to a SNAP calling sequence. 


Octal 

Mnemonic 

Octal 

Mnemonic 

71 

SRCE 

74 

INAW 

72 

MOVE 

74 

OUTC 

73 

IN PC 

75 

OTAC 

73 

INAC 

76 

OUTW 

74 

INPW 

76 

OTAW 

7. Avoid SNAP calls within a loop. 




SYSTEM DUMP 
PRINT MODES 


The mode parameter establishes the format of the dump. The symbolic form is 
used in SNAP statements; the octal form is used with PROGDUMP and FORTDUMP. 


Symbol Octal 


O 

C 

F 

R 

OR or RO 
RC or CR 
RF or FR 


Mode 

octal 

character 

floating point 

register file 

octal and register file 

character and register file 

floating point and register file 
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Examples; 


I SNAP, Lc,B,E, M, ID 


The SNAPSHOT card is put behind a binary deck. SNAPSHOT entry is called 
to obtain relative addressing from COMPASS code as follows: 


IDENT 

FIRST BSS 

UJP 
EXT 

1 

BCD 

NOP 

UJP 

SNPDMP RTJ 


PROG 

0 

SNPDMP 

SNAPSHOT 

BUFY 

BUFY+24 

1, PRGl 
FIRST 

0 

*+2 

SNAPSHOT 


To take a dump after the instruction is executed at fifth location of subprogram 
SUBl, use the following SNAP card; assume BUFY at location 0441 in SUBl. 

O 

g SNAP, (SUBl) 6„ 441*, 465*,O, SNPl 

The area between BUFY and BUFY+24 is dumped in the octal mode. SNPl 
identifies this card. 

PROGDUMP calling sequence: 

RTJ PROGDUMP 

BUFY 

1 BUFY+24 

BCD l.PRGl 
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RECOVERY 

DUMP 


OCTAL 
CORRECTION 
OF LOADED 
PROGRAMS 


DEFINITION OF 
PROGRAM 
EXTENSION 
AREAS 


If a job is terminated abnormally, a post execution dump of non-system mem¬ 
ory is written in octal on OUT unless the programmer has specified in the JOB 
card that it is to be suppressed. The dump consists of console conditions, the 
register file, and non-system memory. The dump is preceded by interrupt 
and trapped instruction information. The format of the dump is that described 
in the systems dump routine if octal and register file options are selected. The 
recovery dump is a separate routine. 


When subprograms have been loaded and control returned to SCOPE, the pro¬ 
grammer may enter octal corrections for the loaded program. The SCOPE 
control statement OCC provides for replacing single or several contiguous 
instructions in the program. The format of the OCC statement is discussed in 
the section on SCOPE control statements. 

The corrections loaded by the OCC statements may replace one or more instruc¬ 
tions or constants in a subprogram, or the programmer may use OCC to define 
a program extension area. 

If an OCC is directed to the same location as a SNAP statement and follows the 
SNAP statement in the SCOPE input, the SNAP is lost. No error is indicated 
and the SNAP calling sequence still consumes available memory. 


If a program extension area is used, it must be defined by an OCC statement in 
the following form: 

g OCC,Xk 

X indicates the definition of the extension area and k is an octal integer indicat¬ 
ing the length of the extension area. If the length, k, exceeds available memory, 
the area is adjusted to the size of available memory. A message is printed on 
OUT and execution is allowed if this is the only error in the run. If loading of 
corrections exceeds the SCOPE defined area, it is handled as memory overflow. 
If the first OCC statement to name X in the location field is of incorrect format, 
it is ignored; an error indication is given; an arbitrary extension area of 777g 
locations (which may be adjusted to fit available memory) is defined. The deck 
is processed to the RUN statement and execution is inhibited. 
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Octal corrections can be made into three areas of memory; subprogram, data 
area and program extension areas. Since compilers and assemblers output in 
the relocatable mode, it is further necessary to use address modifiers to find 
memory locations. For example; if several subprograms are loaded, the 
absolute address of a variable in a particular subprogram is not known. The 
programmer must place the name of the subprogram and the relative address 
on the octal correction card. 

gOCC, (PROG1)70,20000100* 


A correction is to be entered at address 00070 relative to subprogram PROGl. 
The * tells SCOPE to relocate address 00100 relative to subprogram PROGl. 


OCC, (SUB1)77, 20000100*, 40000101(SUB2). 

9 

Put 200XXXXX in location SUBl+77 of subprogram SUBl; relocate 00100 rel¬ 
ative to subprogram SUBl. Put 400XXXXX in location SUBl+100 of subprogram 
SUBl; relocate 00101 relative to subprogram SUB2. 

^ OCC (SUB1)20, 00000036, 0000036, 000036, 00036, 0036, 036, 36. 

9 

Put the octal value 00000036 into locations 20,21,23,23,24,25,26 of subprogram 
SUBl; since values are right justified, 00000036 and 36 both go into memory as 
00000036. 

^OCC,X20. 

9 

g OCC, X, 20000100(SUB1), 40000101*, 20000102*, 40000103*. 

I OCC, +, 20000400(SUB2), 40000401 *, 20000402 (SUB3), 40000403*. 

9 

I OCC, XIO, 2000620(SUB4), 40000621*, 20000622(SUB5), 40000623*. 

9 

The first X assigns 20 locations to the program extension area. The next X puts 
200ZZZZZ into location 1 of the extension area; ZZZZZ is the relocated 
address relative to subprogram SUBl. 400ZZZZZ goes to location 2 of the 
extension area, 200ZZZZZ to 3, and 400ZZZZZ to 4; all ZZZZZ addresses are 
relocated relative to subprogram SUBl. The + card continues stacking informa¬ 
tion in the program extension area; the addresses of the first two corrections are 
relocated relative to subprogram SUB2, the last two are relative to subprogram 
SUB3. 
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The last card starts loading the information pertaining to subprogram SUB4 
and subprogram SUBS into program extension area location 10. 

^OCC, 0,5,10,15,20,25,30,35,40. 
gOCC,+,45,50,55,60,65, 70. 

^OCC,D20,75,100,105,110,115, , 125, , 135. 

The first two cards will put the 14 octal values 5-70 in successive data area 
locations starting with zero. 

The last card will put the 5 octal values 75-115 in successive locations starting 
with data area 20. Data area 25 will be unchanged, 26 will hold 00000125, 27 
will be unchanged and 30 will hold 00000135. 

gOCC, (SUB1)70, OlOOOOlOX, 20000005C, 40000007D 
g OCC, +, 20000007(SUB1)C 

Put instruction OlOXXXXX into location 70 SUBl; XXXXX is modified relative 
to address 10 of the program extension area. Put into SUBl+71 200XXXXX; 
XXXXX is modified relative to the fifth common address; SUBl+72, etc. Put 
20XXXXXX into SUBl+73; XXXXXX is a character address modified relative 
to subprogram SUBl. 


ERRORS IN 
SCOPE DEBUG 

When SCOPE is processing SNAP and OCC statements, errors may result from 
incorrect format or memory overflow. SNAP card errors do not prevent execu¬ 
tion; errors in OCC cards do, except when too large an extension area is 
declared. If SNAP calling sequences overflow memory, execution is inhibited. 

If the system dump routine is not in memory and SNAP statements occur, the 
job is terminated. 
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ERROR 

MESSAGES 


If a SNAP statement is used and the system dump routine is not in memory, 
the run is terminated and this diagnostic is printed: 

***NOSD 

RUN ABORTED 

If an extension area is defined incorrectly, the following is printed: 

***Xnnn 

nnn is the 3-digit octal length of the SCOPE defined extension area. 
The format for all other error diagnostics is the same. 

*mn, COL nn 
mn is the mnemonic 

nn is the actual column number on the card 

at which the error was detected. In certain cases the column number 
will be the last in a field. 
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APPENDIX SECTION 



APPENDIX A 
BINARY CONTROL CARDS 


A 


Control cards which control SCOPE and related systems may be considered in three categories: 

Executive/monitor 

Loader 

PRELIB 

Control cards for executive/monitor are binary cards with a word count of zero. Loader cards are 
binary cards with a non-zero word count. PRELIB control cards are of the identical format of 
executive/monitor control cards. PRELIB also uses loader cards but in a unique manner. 

A control card for any unit is a binary card defined by the hardware when a 7, 9 punch is detected in 
column one. This card is read into memory and examined for punches in rows 3 , 2, 1, 0, 11, 12, of 
column 1; they contain the word count. 

Word count is derived from the relocatable binary information card, RIF, which may contain a variable 
amount of information for storage in one or more computer words. In the RIF card this is an actual 
word count. In other control cards this number is an arbitrary value used to tell the system how the 
information on the card is to be used. 

All legal control cards and the word count are shown in the following table, 

Intra SCOPE Communication 

PRELIB is called by the PRELIB card and is in control until abnormal termination or until two FILE 
cards have been encountered. 

Loader receives control from executive/monitor once per run to load I/O drivers needed immediately 
by SCOPE. During any loading operation, I/O drivers are loaded automatically. For programmer runs 
the loader receives control from executive/monitor when a binary card with non-zero word count is 
read from INP or when a LOAD statement is encountered. Loader retains control until abnormal ter¬ 
mination or until a binary card with a word count of zero is read from INP, or when loading from the 
library when the called program and all externally linked subprograms have been loaded. Loader 
returns control to the POSTLOAD portion of executive/monitor. 
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BINARY CONTROL CARDS 


Name 

Octal 

Word 

Count 

Description 

Check¬ 

sum 

Sub¬ 

system 

CTO 

0 

comment to operator 

no 

EXEC 

DELETE 

0 

delete subprograms 

no 

PRELIB 

ENDREEL 

0 

end of one reel of standard input 

no 

EXEC 

ENDSCOPE 

0 

terminate SCOPE run 

no 

EXEC 

<library name> 

0 

call library program 

no 

EXEC 

EPT 

42 

entry point name 

yes 

LOADER 

EQUIP 

0 

equipment declaration 

no 

EXEC 

EXS 

55 

external symbol declaration 

no 

LOADER 

FILE 

0 

terminate file 

no 

PRELIB 

IDC 

41 

subprogram identification 

yes 

LOADER 

INSERT 

0 

insert subprograms 

no 

PRELIB 

JOB 

0 

declare programmer's job 

no 

EXEC 

LED 

54 

equipment declaration 

no 

LOADER 

LOAD 

0 

load subprograms 

no 

EXEC 

LRL 

45 

local reference list 

yes 

LOADER 

MACRO 

0 

load macro symbolic deck 

no 

PRELIB 

MAIN 

50 

main program declaration 

no 

OVERLAY 

occ 

0 

load octal corrections 

no 

EXEC 

ORIGIN 

0 

establish starting location 

no 

PRELIB 

OVERLAY 

51 

declare program overlay 

no 

OVERLAY 

RECORD 

0 

declare record 

no 

PRELIB 

REPLACE 

0 

replace subprograms 

no 

PRELIB 

REWIND 

0 

rewind magnetic tapes 

no 

EXEC 

RIF 

1-40 

relocatable binary information 

yes 

LOADER 

RUN 

0 

execute object program 

no 

EXEC 

SEGMENT 

52 

declare overla}' segment 

no 

OVERLAY 

SEPOINT 

0 

declare system entry point 

no 

PRELIB 

SEQUENCE 

0 

declare job sequence 

no 

EXEC 


Page 





Octal 

Word 


Check¬ 

Sub¬ 

Name 

Count 

Description 

sum 

system 

SNAP 

0 

establish snapshot parameters 

no 

EXEC 

TRA 

44 

subprogram transfer 

not 

LOADER 

UNIT 

0 

declare PRELIB input unit 

no 

PRELIB 

UNLOAD 

0 

rewind and unload magnetic tape 

no 

EXEC 

XFER 

0 

copy data from standard input 

no 

EXEC 

XNL 

43 

declare external name and linkage 

yes 

LOADER 


tThe TRA card contains a subprogram checksum but it is not checksummed. 


Page 
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APPENDIX B 

INSTALLATION ACCOUNTING 


B 


SCOPE contains an ACCOUNTS table which holds information pertinent to installation accounting. This 
table receives information from the operator and from the programmer control statements SEQUENCE, 
JOB and RUN. SCOPE maintains the ACCOUNTS table but does not perform any accounting function. 
Rather, at appropriate times, SCOPE provides linkage with an installation accounting routine which 
may perform whatever accounting a particular installation deems desirable. The installation may 
elect to have a complex routine which restricts job times and prepares detailed reports; a simple 
routine which merely retrieves accounting information for use at a later time; or no accounting routine. 

Calls to Accounting Routine 


SCOPE provides linkage with the installation accounting routine through the SEQUENCE, JOB, END- 
SCOPE and RUN control statements. SCOPE will update the accounts table before or after the installa¬ 
tion accounting routine is executed. 

Sequence Statement 


processes the accounting record for the preceding job. 
Job Statement 


for a non-stacked job closes the accounting file prepared by the accounting routine prior to the unload¬ 
ing of the ACC output unit. When control is returned to SCOPE, the current ACC is unloaded and ACC 
is equated to CTO. For a stacked job, a new record is opened. 

Endscope Statement 


The installation accounting routine is entered to close out the records for the preceding job and to close 
the file prior to unloading ACC. 

Run Statement 


The accounting routine is entered to set up timing restrictions. 
Accounting Routine Calling Sequence 


The SCOPE call to the accounting routine has the general form: 
RTJ JOBACC 
parameters 

The parameters indicate what control card SCOPE is processing. 
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structure of Accounts Table 

The ACCOUNTS table consists of 12 words which contain the date, local and machine times, sequence 
number of the job in process, the accounting and identification information from the JOB statement, 
and the times declared on the JOB and RUN statements. 

Accounts 

+01 ddmm5rybb 

+11 

+2 I local time in BCD j when SCOPE was 

+3 j machine time in binary I initiated 

+4 sequence number of current job in BCD 

+5 I c field of JOB statement in BCD 

+61 

+7 i field of JOB statement 

+81 run time flags 

+91 

+10 machine time at beginning of job, in binary 
+11 run time limit in BCD 
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APPENDIX C 


C 


The SCOPE input/output control routine, CIO, uses the tables described on the following pages. 
Available Equipment Table (AET) 

Unit Status Table (UST) 

Channel Status Table (CST) 

Running Hardware Table (RHT) 

CIO also addresses CIT. 

AVAILABLE EQUIPMENT TABLE 

The Available Equipment Table (AET) contains up to 50 two-word entries, depending on the equipment 
configuration used. Each entry contains the information necessary for CIO to use the particular hard¬ 
ware unit described in that entry. 

The operator may use the AET control statement to alter AET. 

The word length of the table is recorded in bits 14-0 of the location immediately preceding the table. 
The table has the following format; 


23 22 


18 17 16 15 12 11 


00 


A 

H 

S 



cc 

_ 


23 22 


15 14 


■Reserve 


00 


H 


D ADDR 


A - 0 unit has not been assigned 
1 unit has been assigned 

H - Numeric code, 00-37 , to describe each hardware type 

O 
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R - Reserve 

0 unit is reserved by another computer 
1 unit is available to this computer 

S - 0 unit is operable 
1 unit is not operable 

E - 0 no action 

1 unit of this hardware type to be assigned 

CC - a 12-bit connect code for each unit, the actual machine code to be inserted in the connect 
instruction 

C - an 8-bit code in locations 22-15 corresponding to the channels 0-7, which are available for 
use by this unit. A bit set ON indicates channel availability. If this field contains all zeros, 
there are no channels to which the unit may be connected. CIO will pass control directly to 
the driver for processing of the I/O request. 

DADDR- driver address for the hardware type of the particular unit. 

UNIT STATUS TABLE 

Each two-word entry in the UST contains the current status of a hardware unit. 

UST entry: 


23 22 



17 16 


00 

D 

LF 

_ 

BCR 

23 22 21 1918 17 16 


00 

U 

C 

LC 



STATUS 


1_LP 


D - significant only to the I/O system. 1 unit is static, the last preceding operation on the 
unit is completed. 

0 unit is dynamic. 

LF - last function code (other than status, 13) given for this unit 

BCR - input/output buffer termination address (contained in the buffer control register). If the 
unit is busy, this may not be current. 
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U “ the unit busy indicator 
0 unit is free 
1 unit is busy 


C - channel busy indicator 
0 channel is free 
1 channel is busy 

LC - channel last used by this unit 

STATUS - status replies received from the I/O equipments. If the unit is busy, current unit status 
at the time of the request is pven. If the unit is free, status reflects the results of the 
last completed operation. 

CHANNEL STATUS TABLE 

The Channel Status Table, CST, defines channel status, I/O status and interrupt selections. 

This table consists of up to 8 one-word entries. Each table entry reflects the busy or not busy status 

and user requested interrupt status of a particular channel. The format of the table is; 



AO - AET ordinal of last hardware unit to use this channel 

B - 0 channel not busy 
1 channel busy 

IC - 00 no interrupt selected by the user 

01 abnormal termination (EOT, EOF, LP, PARITY) interrupt selected by user 

10 or 11 end of operation (includes abnormal termination interrupt selected by user) 

I ADDR - user's interrupt subroutine address 

QNNING HARDWARE TABLE 

lis table is a reference for operating hardware units and SCOPE logical units. The Running Hard- 
ire Table, RHT, consists of 63 entries of tv/o octal digits each. The table is arranged by logical 
lit niimber; entry one refers to logical unit one, entry 60 refers to INP, and so forth. Each entry 
mtains the position number in AET and UST of the physical unit to which the logical unit is assigned, 
the entry is zero the logical unit is unassigned. The entry for logical unit number zero is not refer¬ 
eed by CIO. 
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APPENDIX D 

INTERNAL INTERRUPT CONTROL 


SCOPE controls the processing of internal interrupts. The Central Interrupt Control routine, CIC, 
detects the interrupt condition and transfers control to the appropriate user routine. The conditions 
include those defined by the interrupt mask register plus manual interrupt. 

The address of all interrupt routines must be stored in the Central Interrupt Table (CIT) which is 
maintained within CIC. This table contains the following; 

Symbolic 

Location Content Explanation 

CIT +0 Interrupt flag +0 = no interrupt occurred 

Contents of these registers when last interrupt 
occurred. Registers are restored from here on 
exit from CIC. 


+6 Real Time Clock 

+7 Arithmetic Overflow 

+8 , Divide Fault 

+9 Exponent Overflow 

+10 BCD Fault 

+11 Search/Move 

+12 Manual 

+13 Associated Processor 


Initially contains ABNORMAL. Address is set by 
CIO when interrupt is selected. Table is extended 
for each pair of channels added to the hardware 
configuration, up to a total of 21 entries. 

In addition to storing the subroutine address in CIT, the user also sets the appropriate bit in the 
interrupt mask register. 

When an interrupt occurs, CIC determines if the instruction about to be executed is a Disable Interrupt 
command. If so, control returns to the interrupted program. If the instruction is not DINT, CIC 
determines the interrupt subroutine to be entered. The address in CIT is replaced by the address of 
the system entry point, ABNORMAL; and a return jump to the specified interrupt subroutine is exe¬ 
cuted. Only the address portion of the CIT entries 6-21 applies; the operation portion (for 6-11) 
contains the interrupt mask bits. 

Within his interrupt subroutine, the user determines the particular condition which caused the inter¬ 
rupt, clears the condition when processed, and finally, clears the appropriate bits (internal) in the 
interrupt mask register. 


+14 Channel 0 

+15 Channel 1 

+21 Channel 7 


Initially contains ABNORMAL. Set by the user 
selecting the corresponding interrupt. 


+1 (A) 

+2 (Q) 

+3 (Bl) 

+4 (B2) 

+5 (B3) 
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When interrupt occurs, CIC sets the interrupt flag and stores the contents of the registers in CIT. 
After the user subroutine is executed and before return to the point of interrupt, CIC resets the flag 
and restores the registers. The user may access or alter the content of the registers by referencing 
the appropriate CIT entries. 


ORDERING OF LOW NUMBERED MEMORY 


Octal 

Location 

Opera¬ 

tion 

Bit 

Address 

Meaning 

00000 

NOP 


BOOT or ABNORMAL 

set by EXEC 

00001 

UJP 


ABNORMAL 

protect memory overlap 

00002 

XX 

0 


power loss cell 

00003 

00 

0 

ABNORMAL 

Halt on power loss 

00004 

XX 

0 

***** 

program interrupt address 

00005 

NOP 

0 

XX*** 

NOP, receives code 

00006 

01 

0 

yyyyy 

Jump to CIC 

00007 

XX 

X 

xxxxx 

Unused 

00010 

XX 

0 

***** 

program address of trapped instruction 

00011 

77 

■ 

3xx** 

Disable interrupt instruction holds trap 
code 

00012 

01 

1 

zzzzz 

UJP to process trapped instruction 


The symbols have the following meaning: 

X = not used; may contain any bit combinations convenient to the system. These areas are 
reserved for use by SCOPE. 

yyyyy = address of entry to CIC. 

zzzzz = address of OPTBOXS, or ABNORlVfAL if no trapped instructions are indicated. This 
address is set by the loader. 

* = octal digit (3 binary positions) set by the hardware. 

INTERRUPT PROCESSING 

The following sequence of events occurs to process interrupts: 

1. When the hardware recognizes an interrupt, it stores the interrupt code in location 5, 
the return address to the point of interrupt in location 4, and disables further interrupts. 

2. The hardware begins the interrupt processing sequence at location 5 and jumps to CIC 
from location 6. 

3. CIC performs the following operations: 

a. Saves registers A, Q, Bl, B2, B3, in CIT + 1 through CIT + 5. 

b. Sets interrupt flag, CIT + 0, to -0. 
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c. Determines from code in location 5 which of 16 jumps in CIT + 6 through CIT + 21 
to execute. 

d. Based upon decision in c, executes appropriate interrupt subroutine. 

e. Upon return from interrupt subroutine, resets interrupt flag, CIT + 0, to zero. 

f. Restores registers A, Q, Bl, B2, B3, from locations CIT + 1 through CIT + 5. 

g. Enables interrupts, and performs an indirect jump through location 00004 
(UJP, I 4). 

PROTECTION OF ROUTINES 

Certain routines in the main program and the interrupt subroutines must be protected from an inter¬ 
rupt occurring during their execution. To do so, the first executable instruction in the routine must 
be a Disable Interrupt Control, DINT, instruction. 

Furthermore, before exiting, the interrupt flag, CIT + 0, must be tested to determine whether inter¬ 
rupt control had already been disabled by an interrupt. If interrupt control was not disabled, the 
last executed instruction before the jump must be an Enable Interrupt Control Instruction. SCOPE 
routines are coded in this manner. 

TRAPPED INSTRUCTIONS 

Systems programs simiilating the trapped instructions gain control through location 12. These 
routines disable and enable interrupt control as described above for protection of routines. They 
will not cause an interrupt; however, they recognize any interrupt condition. The SCOPE loader is 
responsible for recognizing requirements for trapped instruction simulation and establishing linkage 
to the required routines. 
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APPENDIX E 

PRELIB CONTROL STATEMENTS 


PRELIB is a library program; PRELIB control statements are contained on cards in the same format 
as SCOPE control cards. 

PRELIB prepares or updates a system library tape, LIB, which consists of two files. The first file 
contains SCOPE, including loader, overlay processor, and so forth. File two contains the library 
programs such as COMPASS, FORTRAN, SORT, PRELIB and the system macros, library subroutines, 
user programs and non-system I/O drivers. 

The use of PRELIB and the structure of the control deck is dictated by which file is being maintained. 

The input deck consists of PRELIB control cards, loader cards and, for file two, Hollerith cards 
generally of COMPASS format. 

RECORD STATEMENT 
^RECORD, m 

RECORD is used only for file one maintenjince. The RECORD statement defines the beginning of a new 
record in file one of LIB. RECORD must follow the REPLACE statement prior to the appearance of 
any loader cards in the deck. RECORD must be followed immediately by an ORIGIN statement except 
that any number of SEPOINT statements may intervene. 

The parameter, m, may be the name of an entry point previously defined by PRELIB. It may be an 
entry point name followed by a plus or minus and not more than 5 octal digits, m may be also expressed 
by octal integer of 5 digits or may be omitted. 

The length of programs following the RECORD, m statement and the related ORIGIN cards must not 
exceed the capacity of the available portion of the PRELIB work area. 

UNIT STATEMENT 
gUNIT, u 

UNIT may be used to maintain file one and two. The UNIT statement allows PRELIB input from a unit 
other than INP. PRELIB reads program decks on the designated unit, u, to an end-of-file. The logical 
unit number should not be 60, INP, and m8.y be further restricted by equipment assignments for the cur¬ 
rent job. The unit may contain only loader cards and must not contain PRELIB control cards. When 
the end of file is read, input is resumed from INP. The card images on the unit must conform to the 
rules for PRELIB input deck structures. 
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SEPOINT STATEMENT 


gSE POINT, p 

SEPOINT cards are used only for file one maintenance. The system entry point statement names 
entry points to SCOPE. The entry point name becomes a part of the permanent/system portion of 
the loader symbol table. A programmer may refer to such entry points by declaring the entry point 
names external s3anbols in his source program. 

p is the name of an entry point defined in an EPT or EXS card in the file one input for PRELIB. If p is 
not defined in an EPT pr EXS card, the address defined for ABNORMAL will be assigned. If ABNORMAL 
is undefined 77777^ will be assigned. A diagnostic will result if p is not assigned. 

Only one system entry point name may be declared per card. Any number of SEPOINT statements may 
occur between the REPLACE statement and the FILE statement terminating file one of the LIB modifi¬ 
cation deck. There are no restrictions as to sequence of SEPOINT statements. 

ORIGIN STATEMENT 
^ORIGIN, m 

ORIGIN is used only for file one maintenance. The program following ORIGIN in the PRELIB deck will 
be located at the absolute address expressed by the ORIGIN parameter, m; the parameter has the same 
meaning and is expressed in the same manner as for the gRECORD statement. 

Any number of ORIGIN cards can be used in the PRELIB deck. One ORIGIN must immediately follow 
each RECORD or SEPOINT. Optional ORIGIN cards must follow a TRA card and must precede an 
IDC card except that SEPOINT cards may precede or follow any ORIGIN card. 

FILE STATEMENT 

"file 

There are no parameters for the FILE statement. Every PRELIB input deck must contain two FILE 
statements. If FILE immediately follows the first statement, copy file one on the new LIB and 
process file two input. 

To terminate the modification deck for either of the two files of LIB, the FILE statement is used. 

When the input for modification of file one has been read, the FILE statement instructs PRELIB to 
process the intermediate output. 

When processing is complete, the new file one for the updated LIB is written on the tape unit desig¬ 
nated by the parameter on the PRELIB statement. The information for modification of file two is 
then read and processed by PRELIB. When the second FILE statement is encountered, PRELIB 
writes a second end-of-file terminating the library portion of LIB and returns control to SCOPE. 
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DELETE STATEMENT 


^DELETE, PF, PT 

A single subprogram or a group of contiguous subprograms may be removed from file two of LIB 
using DELETE. Any ninnber of DELETE statements may be in the file two deck. The following 
rules govern the parameters for DELETE: 

PF is the name in the IDC card of the first subprogram to be deleted from file two of LIB. 

PT is the name in the IDC card of the last subprogram to be removed from file two of LIB. 

PF blank, PT not blank. The first and all subprograms to and including PT will be removed from 
file two. 

PT blank, PF not blank. PF and all subsequent subprograms are deleted to the end of file two. 

PF and PT b lank. File two is deleted. 

PF equals PT. Only one subprogram is deleted. 

PT occurs before PF on old LIB. Parameter error. No subprograms are deleted and a diagnostic 
is produced. 

PF does not occur on old LIB. Same as above. 

PT does not occur on old LIB. Same as above. 


INSERT STATEMENT 

^INSERT, P 
y 

Subprogram decks may be inserted into file two of LIB. The subprograms may be on INP or another 
unit. If they are not on INP, a UNIT statement must immediately follow INSERT. 

P names the subprogram after which the new subprograms are to be added. If the INSERT parameter, 
P, is blank and the statement in which the blank occurs is the first card in the PRELIB file two modi¬ 
fication deck, the new subprograms will be added at the beginning of file two. 

If any other INSERT statement has a parameter of blank or P does not occur on the old LIB, the job 
is terminated after a diagnostic. 

REPLACE STATEMENT 

REPLACE deletes and inserts subprograms. The statement has two meanings and two formats: 

File One 

^REPLACE 

This statement deletes the entire first file and a new file one is read into a working area for processing 
by PRELIB, The input for the new file one which follows immediately consists of file one control cards 
and relocatable subprogram decks. File one input is terminated by a ^FILE statement. 
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File Two 


^REPLACE, PF, PT 

PF name in IDC card of first subprogram is to be deleted from file two. 

PT name in IDC card of last subprogram to be deleted from file two. 

Subprograms to be added to LIB may be on INP or another unit. The UNIT statement must imme¬ 
diately follow REPLACE in the PRELIB input. 

When PF is encountered in the old LIB the subprograms on INP or u are written on the new LIB. 

Old LIB is then searched for PT and all intervening subprograms, including PT, are deleted. 

PF and PT operate the same as in the DELETE statement. 

MACRO STATEMENT 

gMACRO, P, u 

Hollerith card images may be written in file two of LIB. COMPASS uses such images to assemble 
macros. Other uses may be defined by other programs. Hollerith decks are preceded in the file two 
PRELIB input by the MACRO statement. 

P is the name of the Hollerith input deck and the name placed in the pseudo-IDC card on LIB; P must 
be present, u is the logical unit number of the tape containing P. If P is on INP, u is blank. 

When the MACRO statement is encountered, PRELIB write a special card on the new LIB identical in 
format to an IDC card, but with a word count of 7 O 3 . Cards are copied from INP or u until an END 
card identical in format to a COMPASS END card is encountered. Each Hollerith card copied on LIB 
has a word count of 71g. The card images are converted to BCD, and are packed two per 40-word 
record. Card columns 77 through 80 of the Hollerith cards are lost. 

If an end-of-file is reached before an END card, a diagnostic is produced and the job is terminated. 

In editing the resulting tape, the named pseudo-programs may be deleted or replaced, or otherwise 
used as a reference point. Individual card images within a macro program may not be edited without 
replacing the entire program. Any number of cards may be included in a macro program on LIB. 

OTHER PRELIB INPUTS 

In addition to PRELIB Control Statements, PRELIB will accept all loader cards. OCC cards may not 
be input for either file onfe or file two maintenance. 

If a subprogram is called, the loader searches file two of LIB until an IDC card is found. The loader 
examines the EPT cards following the IDC card until the first non EPT card. When the first non EPT 
card is reached the loader skips to the next IDC card and begins the search again. 
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LIB is searched until the end-of-file. If no subprograms were loaded, the loader produces error 
flags and diagnostics for any undefined EXT entries in the loader symbol table and transfers control 
to SCOPE. If subprograms were loaded, LIB is rewound and file two is searched again. The process 
is repeated until all called subprograms on LIB have been loaded. 




PRELIB Control Cards 

LIB File 



DELETE 

Delete Subprogram 

F2 



FILE 

Terminate LIB File 

FI, F2 



INSERT 

Insert Subprogram 

F2 



MACRO 

Load Hollerith Cards on LIB 

F2 



ORIGIN 

Originate Subprogram Absolutely 

FI 



RECORD 

Begin Record on 

FI 



REPLACE 

Replace File One of LIB 

FI 



Replace Subprogram on LIB 

F2 



SE POINT 

Define System Entry Point 

FI 



UNIT 

Load from Unit 

FI, F2 



Card formats are identical to SCOPE control cards 



Word 

Count 

(octal) 

Name 

Detail Cards for PRELIB 


LIB File 

1-40 

RIF 

Relocatable Binary Information 


FI, F2 

41 

IDC 

Program Identification 


FI, F2 

42 

EPT 

Entry Point Name 


FI, F2 

43 

XNL 

External Name 


FI, F2 

44 

TRA 

Transfer 


FI, F2 

45 

LRL 

Local Reference List 


FI, F2 

50t 

MAIN 

Main Overlay Program 


F2 

5 it 

OVERLAY 

Overlay Program 


F2 

52t 

SEGMENT 

Overlay Segment 


F2 

54t 

LED 

Loader Equipment Declaration 


F2 

55t 

EXS 

Externa] Symbol 


FI, F2 

70 


Dummy IDC for MACRO 


F2 

71 

<BCD> 

Identifier for BCD card image for MACRO 

F2 


tGard in Hollerith except for column 1 
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APPENDIX F 

TYPICAL DECK STRUCTURES 


F 


ASSEMBLY AND EXECUTION 

SCOPE monitor system performs the following functions; 

Maintain continuity of processing 

Loads and links subprograms and library subroutines 

Manipulates I/O equipments as directed 

Initiates program execution 

Communicates with the operator 

Transfers records to a logical unit 

Assigns I/O devices as directed 

The arrangement and content of the control statements indicate to SCOPE the manner in which a job 
is to be processed. Jobs are submitted on the standard input unit; control statements may be entered 
via the standard input unit or the comment from operator unit. 

A job is a closed unit of processing for a single account. A run is a single program or library pro¬ 
gram execution. 

The examples illustrate the deck arrangement for assembly and execution of COMPASS programs. 
Non-stacked jobs are not considered. 

A subprogram must begin with an ID ENT card and terminate with an END card. Any number of sub¬ 
programs may follow the ^COMPASS card. The FINIS card must terminate the deck of subprograms 
to be assembled. 
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Execute 



Load binary object program from unit 56 


End of assembly deck 

COMPASS source program. Each must begin 
with an INDENT card and terminate with an 
END card 

Define logical unit 56, the standard load-and- go 
unit, as magnetic tape 


1. Assemble and write the binary object program on load-and-go unit (56), and list the source and 
object program on the standard output unit. 


ASSEMBLY ONLY Assemble a COMPASS program or subprogram. 
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Source input on logical unit 60. Binary deck punched on logical unit 62. Source and object programs 
listed on logical unit 61. 


The EQUIP statement is not required because system units 60, 61, and 62 are defined on the system 
library. 


EXECUTION ONLY Execute directly from standard input unit. 
General Structure: 


z 


data 


|^gRUN,t, 


NM 


^ binary object 


program 


|^EQUIP,U]^=dj^,U2=d2,.. ♦ 


/ gJOB,c,i,t 
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If data is included on the standard input unit, it must follow the RUN card. Several executions 
may be performed in the same job. Programmer units must be defined prior to their use; scratch 
units must be defined prior to each run in which they are used. 


Example; 




£ 


I binary object p rogram #2 
|^EQUIP,55=MT,56=MI 




/I 


^data for program #1 


RUN,10 




#1 


^binary object program 


gEQUIF,15=CR,16=CP,20=MT,55=MT 




Execution time limit: 7 minutes. 
Map on standard output unit 


Scratch units 55 and 56 defined as 
magnetic tape for second r\m. 


Execute the first object program. 
Time limit: 10 minutes. Memory 
map is written on standard output 
unit. 


Charge number: ACC 123. Programmer: DS. 
Job time limit: 20 minutes. 


1. Logical unit 15 defined as card reader, 16 as card pimch, 20 as magnetic tape. These programmer 
units remain defined for the job. Scratch unit 55 is defined as magnetic tape for the first run only; 
it is rewound at end of first run. 
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EXECUTE FROM A PROGRAMMER UNIT 

General Structure: 



Subprograms may be loaded from different programmer units, but only one LOAD card may appear. 
Equipment used in LOAD must be defined. If data is to be included on the standard input unit, it 
follows RUN card. 


Example: 



gEQUIP 

Load binary subprograms from logical unit 36 until end-of-file. Load binary subprograms from logical 
unit 37, until end-of-file. 
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ASSEMBLY AND EXECUTION 


Assemble a COMPASS program and execute it immediately. 


General Structure: 


data 




gRUN,t,NM 


/^OAEi, U] , U2 , U3 




FINIS 


£ 




fiource program 


COMPASS, <assembly options> 


/9EQUIP ,u^=cl^ ,U2=d2,. .. ,u^=d^ 


JOB,c,i,t 


If the data is to be included on the standard input unit, it must follow the RUN card. For assembly 
only, any niunber of subprograms may follow the COMPASS card terminated by FINIS, 

Although the load-and-go tinit is a system unit, it must be defined by an EQUIP card. 


F-6 



Example; 



1. Source input on logical unit 60. Binary object program written on load-and-go unit 56. Binary 
deck punched on unit 62. Source and object programs listed on unit 61. 

2. FINIS card signals end of assembly. Punch starting in column 10. End-of-file mark is written 
after last subprogram on unit 56. 

3. Rewind load-and-go unit, 56 and load binary subprograms from it until end-of-file. It is avail¬ 
able as a scratch unit in the following run. 
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Example: 




RUN, 8 




binary object subprogram 

A 


.LOAD,15 


A 


.REWIND, 15 


FINIS 


2 . 


A 


^EQUIP,15=MT 
g JOB,ACC123,DS,12 


source subprograms 


1, ^COMPAS S, X=15 


Execution time limit: 8 minutes. 
Map written on standard output unit. 


Load binary subprograms from unit 15. 
Rewind programmer unit 15. 


Programmer unit 15 is defined as magnetic tape. 

Charge number: ACC 123. Programmer: DS. 

Job time limit: 12 minutes. 


1. ^COMPASS, X = 15 
y 

Source input is on logical unit 60. Binarj' object subprograms are written on programmer unit 15. 

2. FINIS card signals end of assembly. Pimch starting in column 10. An end-of-file mark is written 
after the last subprogram on unit 15. 
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ASSEMBLE AND EXECUTE 


Include previously assembled binary decks In the program. 
General Structure; 



After assembly Is completed, the subprograms may be loaded In any order. Binary object subprograms 
on the standard input must follow the LOAD card. Linkage does not occur until all subprograms are 
loaded. If a programmer unit is chosen for the load-and-go option, it must be rewound by the REWIND 
statement before it is loaded. 
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Example; 




RUN, 8 




Execute time limit; 8 minutes, 

Map is written on standard output unit. 


3. 




binary object subprogram 


A 


2. 


LOAD,16,15 


/7 


REWIND,15,16 




FINIS 


ZI 


r 


source subprograms 


COMPASS, X= 15 




A 


^ binary object subprogram 
XFER,16 


EQUIP,15=Mr,16=Mr 


gJOB,ACC123,DS,12 


Source input is on logical unit 60. 
Binary object subprograms are written 
on programmer unit 15. 


Programmer units 15 and 16 are defined as 
magnetic tape. 

Charge number; ACC 123. Programmer; DS. 
Job time limit; 12 minutes. 


1. Transferred to logical unit 16. Binary information up to COMPASS control card is transferred 
to unit 16; end-of-file mark is written and back-spaced over. 

2. FINIS signals end of assembly. Punch starting in column 10. An end-of-file mark is written 
after the last subprogram on unit 15. COMPASS source language subprograms, each terminated 
by an END card. 

3. Load binary subprograms from unit 16, until end-of-file; then from unit 15 until end-of-file. 
Rewind programmer miits 15 and 16. 
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Binary object subprograms may be transferred from the standard input unit to another logical tape 
unit. If this unit is a programmer or scratch unit, it must be rewound before it can be loaded. 


General Structure: 
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Compilation of a Single COBOL Program 

The COBOL source program and binary object 
program are listed on OUT. The binary object 
program is also punched on PUN. 


Execute directly from the standard input unit. 


Load from two programmer units and INP. 
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Sequential execution using EQUIP statements 




^ data for program #2 


gRUN,7 




^ binary object program #2 


^ data for program #1 
(^gRUN,10 


^ binary object program #1 

^EQUIP,16=CP _ 

^^EQUIP,15=CR 


J. JOB,ACC123,DS,20 


Unit assignments by EQUIP statements 
remain in effect for the duration of the 
job or imtil changed by another EQUIP 
statement. 


/r 


RUN,20 


A 


LOAD,56 


FINIS 


r 


END 




PROGRAM KRIK 


i: 




|^gCOMPASS,X 


FINIS 


END 


Assemble COMPASS and FORTRAN sub¬ 
programs. Execute the program. 




IDENT BENYA 


A 


I^FORTRAN, <parameters> 
|^EQUIP,56=MT 


JOB,ACC123,DS,22 
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Compile and load a FORTRAN 
program. Load a binary subpro - 
gram from INP and execute. 


Use of debugging aids, 
precede RUN. 


OCC and SNAP cards 


data 


n 

9 


RUN,10 


^SNAP 


|^^OCC,Pi.-,p^ 










binary object programs 


LOAD,15 


REWIND,15 


FINIS 


/! 


il. 


& 


L 


FORTRAN program 


FORTRAN,X=15 


EQUIP,15=MT 


JOB,ACC123,DS,12 


4 




















APPENDIX G Q 

STANDARD LABELS 3000 SERIES ^ 
MAGNETIC TAPE 


Character Position 


1 

recording density (2, 5, or 8, indicating 200, 
556, or 800 bpi) 

2-3 

unique label identifier - () 

4-5 

logical unit number - 2 BCD digits 

6-8 

retention cycle - 3 BCD digits 

9-22 

file name - 14 alphanumeric characters 

23-24 

reel number - 2 BCD digits 

25-30 

date written - Month, Day, Year in BCD 
(MMDDYY) File ID 

31-32 

edition number - 2 BCD digits 

33-80 

user supplied information 
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APPENDIX H H 



OPERATOR CONTROL STATEMENTS 
















































































3200 


SCOPE GENERALIZED FLOW 














































































CONTROL DATA SALES OPPICBS 

ALAMOGORDO • ALBUQUERQUE • ATLANTA • BILLINGS • BOSTON • CAPE 
CANAVERAL • CHICAGO • CINCINNATI • CLEVELAND • COLORADO SPRINGS 
DALLAS • DAYTON • DENVER • DETROIT • DOWNEY, CALIFORNIA • HONOLULU 
HOUSTON • HUNTSVILLE • ITHACA • KANSAS CITY, KANSAS • LOS ANGELES 
MADISON, WISCONSIN • MINNEAPOLIS • NEWARK • NEW ORLEANS • NEW 
YORK CITY • OAKLAND • OMAHA • PALO ALTO • PHILADELPHIA • PHOENIX 
PITTSBURGH . SACRAMENTO • SALT LAKE CITY • SAN BERNARDINO • SAN 
DIEGO • SEATTLE • ST. LOUIS • WASHINGTON, D.C. 


ATHENS > BOMBAY > CANBERRA • DUSSELDORF • FRANKFUR\' 

HAMBURG • JOHANNESBURG • LONDON • MELBOURNE 

(REGAL ELECTRONICA DE MEXICO, S.A.) • MILAN • MONTREA 

OSLO • OTTAWA • PARIS • STOCKHOLM • STUTTGART • SYDNE 

TOKYO (C. ITOH ELECTRONIC COMPUTING SERVICE CO., LTD.) lORv... * 

ZURICH 


CONTROL DATA 

C. c) R P O K A T i O N 


8100 34tli AVE. SO., MINNEAPOLIS, MINN. 55440 


Pub. No. 60057700 


